Estrutura DDVIDEOPORTCONNECT (ksmedia.h)
A estrutura DDVIDEOPORTCONNECT descreve uma conexão de porta de vídeo de hardware.
Sintaxe
typedef struct _DDVIDEOPORTCONNECT {
DWORD dwSize;
DWORD dwPortWidth;
GUID guidTypeID;
DWORD dwFlags;
ULONG_PTR dwReserved1;
} DDVIDEOPORTCONNECT, *LPDDVIDEOPORTCONNECT;
Membros
dwSize
Especifica o tamanho em bytes da estrutura DDVIDEOPORTCONNECT .
dwPortWidth
Especifica a largura da porta de vídeo de hardware. Esse valor representa o número de pinos físicos na porta de vídeo de hardware. Esse membro sempre deve ser preenchido, mesmo quando o guidTypeID pressupõe um determinado tamanho.
guidTypeID
Especifica um GUID que descreve as características de sincronização da porta de vídeo de hardware. Os seguintes tipos de porta são predefinidos:
| Tipo de Porta | Descrição |
|---|---|
| DDVPTYPE_E_HREFH_VREFH | Sincronizações externas em que HREF está ativo alto e VREF está ativo alto. |
| DDVPTYPE_E_HREFH_VREFL | Sincronizações externas em que HREF está ativo alto e VREF está ativo baixo. |
| DDVPTYPE_E_HREFL_VREFH | Sincronizações externas em que HREF está ativo baixo e VREF está ativo alto. |
| DDVPTYPE_E_HREFL_VREFL | Sincronizações externas em que HREF está ativo baixo e VREF está ativo baixo. |
| DDVPTYPE_BROOKTREE | As informações de sincronização são inseridas no fluxo de dados usando a definição brooktree. |
| DDVPTYPE_CCIR656 | As informações de sincronização são inseridas no fluxo de dados de acordo com a especificação de CCIR656. |
| DDVPTYPE_PHILIPS | As informações de sincronização são inseridas no fluxo de dados usando a definição philips. |
dwFlags
Especifica um conjunto de sinalizadores que identificam os recursos da conexão de porta de vídeo de hardware. Esse membro pode ser um OR bit a bit de qualquer um dos seguintes sinalizadores:
| Sinalizador | Significado |
|---|---|
| DDVPCONNECT_DISCARDSVREFDATA | O dispositivo descarta todos os dados gravados durante o período VREF, fazendo com que esses dados não sejam gravados no buffer de quadros. Esse sinalizador deve ser definido apenas pelo driver. |
| DDVPCONNECT_DOUBLECLOCK | Quando definido pelo driver, esse sinalizador indica que a porta de vídeo de hardware é capaz de marcar os dados duas vezes. Quando definido pelo cliente, ele indica que a porta de vídeo de hardware deve marcar os dados duas vezes. Esse sinalizador é válido apenas em uma porta de vídeo de hardware com um guidTypeID que dá suporte a uma sincronização externa. |
| DDVPCONNECT_HALFLINE | Quando definido pelo driver, esse sinalizador indica que a porta de vídeo de hardware dá suporte à gravação de meias linhas no buffer de quadros, às vezes fazendo com que os dados não sejam exibidos corretamente. Quando definido pelo cliente, ele indica que o driver pode gravar meias linhas. |
| DDVPCONNECT_INTERLACED | Quando definido pelo driver, esse sinalizador indica que a porta de vídeo de hardware dá suporte a sinais entrelaçados. Quando definido pelo cliente, ele indica que o sinal está entrelaçado. |
| DDVPCONNECT_INVERTPOLARITY | Quando definido pelo driver, esse sinalizador indica que a porta de vídeo de hardware é capaz de inverter as polaridades do campo; ou seja, tratando até campos como ímpares e vice-versa. Quando definido pelo cliente, ele indica que a porta de vídeo de hardware deve inverter as polaridades do campo. |
| DDVPCONNECT_SHAREEVEN | Atualmente, esse é um recurso não simplificado e deve ser ignorado pelo driver. |
| DDVPCONNECT_SHAREODD | Atualmente, esse é um recurso não simplificado e deve ser ignorado pelo driver. |
| DDVPCONNECT_VACT | Quando definido pelo driver, esse sinalizador indica que a porta de vídeo de hardware é capaz de usar um sinal VACT externo. Quando definido pelo cliente, ele indica que a porta de vídeo de hardware deve usar o sinal VACT externo. |
dwReserved1
Reservado para uso do sistema e deve ser definido como zero.
Comentários
A rotina de retorno de chamada DdVideoPortGetConnectInfo do driver inicializa uma estrutura DDVIDEOPORTCONNECT para cada conexão compatível com a porta de vídeo de hardware. O cliente pode alterar o membro dwFlags de uma das estruturas DDVIDEOPORTCONNECT do driver antes de chamar o retorno de chamada DdVideoPortCanCreate do driver.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | ksmedia.h (inclua Dvp.h) |