Share via

NuiImageStreamReleaseFrame

  • Article

Kinect for Windows 1.5, 1.6, 1.7, 1.8

Releases the specified frame of data from the specified stream.

Syntax

HRESULT NuiImageStreamReleaseFrame(
         HANDLE hStream,
         const NUI_IMAGE_FRAME *pImageFrame
)

Parameters

  • hStream
    Type: HANDLE
    [in] A handle to the stream.

    Note

    You must open the stream by calling the NuiImageStreamOpen function, before calling NuiImageStreamReleaseFrame.

  • pImageFrame
    Type: NUI_IMAGE_FRAME
    [in] A pointer to the frame to release.

Return Value

Type: HRESULT
Returns S_OK if successful; otherwise, returns one of the failure codes in the following table.

Error Description
E_INVALIDARG The value of the hStream or the pImageFrame parameter is NULL.
E_NOINTERFACE The pFrameTexture member of the pImageFrame parameter is NULL.
E_NUI_DEVICE_NOT_READY The Kinect has not been initialized. Refer to NuiInitialize.

Remarks

Important

Reset the notification event for the stream, before calling NuiImageStreamReleaseFrame.

Requirements

Header: Declared in NuiImageCamera.h; however, include NuiApi.h in your project.