DD_DXAPI_OPENVPCAPTUREDEVICE código de controle

Artigo
06/13/2024

Um driver de captura de vídeo passa DD_DXAPI_OPENVPCAPTUREDEVICE no parâmetro dwFunctionNum da função DxApi para abrir o dispositivo para captura de vídeo.

Parâmetros de Entrada

lpvInBuffer
Ponteiro para uma estrutura DDOPENVPCAPTUREDEVICEIN que contém as informações relevantes do objeto VPE necessárias para a captura.

Parâmetros de saída

lpvOutBuffer
Ponteiro para uma estrutura DDOPENVPCAPTUREDEVICEOUT que contém o novo identificador de captura.

Comentários

Um dispositivo de captura VPE permite que os dados da porta de vídeo de hardware sejam automaticamente transferidos da superfície para um buffer especificado. A abertura do dispositivo de captura determina quais linhas devem ser capturadas. Por exemplo, para VBI, o driver de captura pode estar interessado apenas nas primeiras 21 linhas. Se o driver de captura quiser capturar regiões diferentes para buffers diferentes (por exemplo, VBI e vídeo para buffers separados), vários dispositivos de captura poderão ser criados.

Quando um dispositivo de captura é criado, o transporte de vídeo no modo kernel cria uma fila para cada dispositivo. O driver pode adicionar buffers posteriormente a essa fila. Cada vez que a V-sync da porta de vídeo de hardware ocorre, o transporte de vídeo no modo kernel inicia automaticamente os mestres de barramento corretos da superfície do buffer de quadros preenchida mais recentemente pela porta de vídeo de hardware para o buffer na fila. Se você não quiser capturar em todos os campos, você pode indicar isso definindo o membro dwCaptureEveryNFields de DDOPENVPCAPTUREDEVICEIN para algo diferente de 1.

Os membros hDirectDraw e hVideoPort de DDOPENVPCAPTUREDEVICEIN especificam o objeto DirectDraw e o objeto VPE do qual você deseja capturar. Os membros dwStartLine e dwEndLine indicam quais linhas devem ser capturadas. O membro dwStartLine é relativo ao início da superfície (0 é a primeira linha) e dwEndLine é inclusivo (definir dwStartLine e dwEndLine como 0 faz com que a primeira linha seja capturada).

O driver também deve especificar um retorno de chamada que é chamado quando o dispositivo de captura se torna inutilizável devido ao objeto VPE sendo liberado no modo de usuário. O membro pContext de DDOPENVPCAPTUREDEVICEIN contém um valor que é passado se a função de retorno de chamada pfnCaptureClose for chamada.

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

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