DD_DXAPI_OPENSURFACE Steuerelementcode

Artikel
06/13/2024

Ein Videoaufnahmetreiber übergibt DD_DXAPI_OPENSURFACE im dwFunctionNum-Parameter der DxApi-Funktion , um den Kernelmodus-Videotransport zu benachrichtigen, dass der Treiber ein Surface-Objekt benötigt.

Eingabe-Parameter

lpvInBuffer
Zeigen Sie auf eine DDOPENSURFACEIN-Struktur , die die DirectDrawSurface-Objektinformationen enthält.

Ausgabeparameter

lpvOutBuffer
Zeiger auf eine DDOPENSURFACEOUT-Struktur , die die neuen DirectDrawSurface-Handleinformationen enthält.

Hinweise

Das Objekt wird durch das dwSurfaceHandle-Element von DDOPENSURFACEIN angegeben, das vom Benutzermodus übergebene Handle ist. Das hDirectDraw-Element von DDOPENSURFACEIN gibt das DirectDraw-Objekt an, dem die Oberfläche zugeordnet ist. Der Treiber muss auch einen Rückruf angeben, der aufgerufen wird, wenn die Oberfläche aufgrund der Veröffentlichung im Benutzermodus, einer Eingabeaufforderung im Vollbildmodus oder einer Änderung des Modus nicht mehr verwendet werden kann. Das pContext-Element enthält einen Wert, der übergeben wird, wenn die pfnSurfaceClose-Rückruffunktion jemals aufgerufen wird.

Wenn das ddRVal-Element von DDOPENSURFACEOUT auf DD_OK festgelegt ist, ist die Ausgabe dieses Funktionsbezeichners ein neuer Oberflächenziehpunkt. Dieser neue Handle muss für alle nachfolgenden Aufrufe verwendet werden, die auf diese Oberfläche verweisen.

Dieser Funktionsbezeichner kann nur aus PASSIVE_LEVEL aufgerufen werden.