Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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.