DD_DXAPI_OPENDIRECTDRAW Steuerelementcode

Artikel
06/13/2024

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

Eingabe-Parameter

lpvInBuffer
Zeiger auf eine DDOPENDIRECTDRAWIN-Struktur , die die DirectDraw-Handleinformationen enthält.

Ausgabeparameter

lpvOutBuffer
Zeiger auf eine DDOPENDIRECTDRAWOUT-Struktur , die die neuen DirectDraw-Handleinformationen enthält.

Hinweise

Das Objekt wird durch das dwDirectDrawHandle-Element von DDOPENDIRECTDRAWIN angegeben, das vom Benutzermodus übergebene Handle ist. Der Treiber muss auch einen Rückruf angeben, der aufgerufen wird, wenn das DirectDraw-Objekt wegfällt. Das pContext-Element von DDOPENDIRECTDRAWIN enthält einen Wert, der übergeben wird, wenn der pfnDirectDrawClose-Rückruf jemals aufgerufen wird.

Wenn das ddRVal-Mitglied von DDOPENDIRECTDRAWOUT auf DD_OK festgelegt ist, ist die Ausgabe dieses Funktionsbezeichners ein neues DirectDraw-Handle. Dieses neue Handle muss für alle nachfolgenden Aufrufe verwendet werden, für die ein DirectDraw-Handle erforderlich ist.

Dieser Funktionsbezeichner kann nur aus PASSIVE_LEVEL aufgerufen werden.