Compartilhar via

PDD_VPORTCB_GETVPORTCONNECT função de retorno de chamada (ddrawint.h)

  • Artigo

A função de retorno de chamada DdVideoPortGetConnectInfo retorna as conexões compatíveis com o objeto VPE especificado.

Sintaxe

PDD_VPORTCB_GETVPORTCONNECT PddVportcbGetvportconnect;

DWORD PddVportcbGetvportconnect(
  PDD_GETVPORTCONNECTDATA unnamedParam1
)
{...}

Parâmetros

unnamedParam1

Aponta para uma estrutura DD_GETVPORTCONNECTDATA que contém as informações necessárias para que o driver retorne os dados de conexão do objeto VPE.

Retornar valor

DdVideoPortGetConnectInfo retorna um dos seguintes códigos de retorno de chamada:

Comentários

DdVideoPortGetConnectInfo deve ser implementado em drivers DirectDraw que dão suporte a VPE.

O DirectDraw chama DdVideoPortGetConnectInfo para obter o número de conexões compatíveis com o objeto VPE especificado e as características de cada conexão. DdVideoPortGetConnectInfo é chamado duas vezes para o objeto VPE especificado:

  • Na primeira chamada, o membro lpConnect da estrutura DD_GETVPORTCONNECTDATA em lpGetConnect é NULL. O driver deve gravar o número de conexões compatíveis com o objeto VPE no membro dwNumEntries do DD_GETVPORTCONNECTDATA. Após o retorno, o DirectDraw alocará esse número de estruturas DDVIDEOPORTCONNECT para passar a segunda chamada para DdVideoPortGetConnectInfo.
  • Na segunda chamada, lpConnect aponta para a matriz de estruturas DDVIDEOPORTCONNECT alocadas. O driver deve preencher cada estrutura para descrever cada conexão compatível com o objeto VPE. O driver também deve retornar o número de conexões com suporte em dwNumEntries. Observe que o driver tem a garantia de que o buffer para o qual o lpConnect aponta é grande o suficiente para manter as informações de conexão que estão sendo solicitadas.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho ddrawint.h (inclua Winddi.h)

Confira também

DDVIDEOPORTCONNECT

DD_GETVPORTCONNECTDATA