DD_DXAPI_OPENVIDEOPORT código de controle

Artigo
06/13/2024

Um driver de captura de vídeo passa DD_DXAPI_OPENVIDEOPORT no parâmetro dwFunctionNum da função DxApi para notificar o transporte de vídeo no modo kernel de que o driver requer uma porta de vídeo de hardware.

Parâmetros de Entrada

lpvInBuffer
Ponteiro para uma estrutura DDOPENVIDEOPORTIN que contém as informações do objeto VPE do DirectDraw.

Parâmetros de saída

lpvOutBuffer
Ponteiro para uma estrutura DDOPENVIDEOPORTOUT que contém as novas informações de identificador de objeto VPE.

Comentários

O objeto é especificado pelo membro dwVideoPortHandle de DDOPENVIDEOPORTIN, que é a ID da porta de vídeo de hardware especificada quando o objeto VPE foi criado no modo de usuário. O membro hDirectDraw de DDOPENVIDEOPORTIN especifica o objeto DirectDraw ao qual a porta de vídeo está associada. O driver também deve especificar um retorno de chamada que é chamado quando o objeto VPE se torna inutilizável devido a ele ser liberado no modo de usuário. O membro pContext de DDOPENVIDEOPORTIN contém um valor que é passado se a função de retorno de chamada pfnVideoPortClose for chamada.

Se o membro ddRVal de DDOPENVIDEOPORTOUT estiver definido como DD_OK, a saída desse identificador de função será um novo identificador de superfície do DirectDraw. Esse novo identificador deve ser usado em todas as chamadas subsequentes que fazem referência a esse objeto VPE.

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