none
Kinect deprecated APIs should be marked __declspec(deprecated) RRS feed

  • Question

  • Please mark in the headers and/or cpp that parts of the Kinect SDK 2.0 are deprecated.

    I am discovering, in a reactive way, Kinect SDK 2.0 apis which should never be called and that return bad data.
    e.g. get_KinectCapabilities()

    Two things are needed:
    1) Reference documentation should clearly indicated this is a deprecated api, it returns bad data, and should never be called
    2) Mark the API as deprecated in the SDK itself (headers, cpp, etc.)

    The later step 2 is of significant interest. This step can immediately provide feedback to a user of the APIs.

    C++ provides a mechanism for this using:  

    __declspec(deprecated(MY_TEXT))


    http://msdn.microsoft.com/en-us/library/044swk7y.aspx


    --Dale

    Thursday, December 18, 2014 12:24 PM