DD_DXAPI_OPENDIRECTDRAW control code
A video capture driver passes DD_DXAPI_OPENDIRECTDRAW in the dwFunctionNum parameter of the DxApi function to notify the kernel-mode video transport that the driver requires a DirectDraw object.
Input Parameters
- lpvInBuffer
Pointer to a DDOPENDIRECTDRAWIN structure that contains the DirectDraw handle information.
Output Parameters
- lpvOutBuffer
Pointer to a DDOPENDIRECTDRAWOUT structure that contains the new DirectDraw handle information.
Remarks
The object is specified by the dwDirectDrawHandle member of DDOPENDIRECTDRAWIN, which is the handle passed down from user mode. The driver must also specify a callback that is called if the DirectDraw object goes away. The pContext member of DDOPENDIRECTDRAWIN contains a value that is passed if the pfnDirectDrawClose callback is ever called.
If the ddRVal member of DDOPENDIRECTDRAWOUT is set to DD_OK, the output from this function identifier is a new DirectDraw handle. This new handle must be used on all subsequent calls that require a DirectDraw handle.
This function identifier can only be called from PASSIVE_LEVEL.
Requirements
Header |
Ddkmapi.h (include Ddkmapi.h) |
See also
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for