DD_DXAPI_OPENSURFACE控制代码

项目
02/12/2024

视频捕获驱动程序在 DxApi 函数的 dwFunctionNum 参数中传递DD_DXAPI_OPENSURFACE，以通知内核模式视频传输驱动程序需要 Surface 对象。

输入参数

lpvInBuffer
指向包含 DirectDrawSurface 对象信息的 DDOPENSURFACEIN 结构的指针。

输出参数

lpvOutBuffer
指向包含新 DirectDrawSurface 句柄信息的 DDOPENSURFACEOUT 结构的指针。

注解

该对象由 DDOPENSURFACEIN 的 dwSurfaceHandle 成员指定，该成员是从用户模式向下传递的句柄。 DDOPENSURFACEIN 的 hDirectDraw 成员指定与图面关联的 DirectDraw 对象。驱动程序还必须指定在图面因在用户模式、全屏命令提示符下释放或模式更改而不可用时调用的回调。 pContext 成员包含一个值，如果曾经调用 pfnSurfaceClose 回调函数，则传递该值。

如果 DDOPENSURFACEOUT 的 ddRVal 成员设置为 DD_OK，则此函数标识符的输出是新的图面句柄。此新句柄必须用于引用此图面的所有后续调用。

此函数标识符只能从PASSIVE_LEVEL调用。