DD_DXAPI_OPENSURFACE código de controle

Artigo
06/13/2024

Um driver de captura de vídeo passa DD_DXAPI_OPENSURFACE no parâmetro dwFunctionNum da função DxApi para notificar o transporte de vídeo no modo kernel de que o driver requer um objeto de superfície.

Parâmetros de Entrada

lpvInBuffer
Ponteiro para uma estrutura DDOPENSURFACEIN que contém as informações do objeto DirectDrawSurface.

Parâmetros de saída

lpvOutBuffer
Ponteiro para uma estrutura DDOPENSURFACEOUT que contém as novas informações do identificador DirectDrawSurface.

Comentários

O objeto é especificado pelo membro dwSurfaceHandle de DDOPENSURFACEIN, que é o identificador transmitido do modo de usuário. O membro hDirectDraw de DDOPENSURFACEIN especifica o objeto DirectDraw ao qual a superfície está associada. O driver também deve especificar um retorno de chamada que é chamado quando a superfície se torna inutilizável devido a ele ser liberado no modo de usuário, um prompt de comando de tela inteira ou uma alteração de modo. O membro pContext contém um valor que é passado se a função de retorno de chamada pfnSurfaceClose for chamada.

Se o membro ddRVal de DDOPENSURFACEOUT estiver definido como DD_OK, a saída desse identificador de função será uma nova alça de superfície. Esse novo identificador deve ser usado em todas as chamadas subsequentes que fazem referência a essa superfície.

Esse identificador de função só pode ser chamado a partir de PASSIVE_LEVEL.