Compartilhar via

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

  • Artigo

A função de retorno de chamada DdVideoPortGetInputFormats determina os formatos de entrada que o objeto VPE DirectDraw pode aceitar.

Sintaxe

PDD_VPORTCB_GETINPUTFORMATS PddVportcbGetinputformats;

DWORD PddVportcbGetinputformats(
  PDD_GETVPORTINPUTFORMATDATA unnamedParam1
)
{...}

Parâmetros

unnamedParam1

Aponta para uma estrutura DD_GETVPORTINPUTFORMATDATA que contém as informações necessárias para o driver retornar os formatos de entrada que o objeto VPE pode aceitar.

Valor retornado

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

Comentários

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

O DirectDraw chama DdVideoPortGetInputFormats para obter o número de formatos de entrada compatíveis com o objeto VPE especificado e uma descrição de cada formato. DdVideoPortGetInputFormats é chamado duas vezes para o objeto VPE especificado:

  • Na primeira chamada, o membro lpddpfFormat da estrutura DD_GETVPORTINPUTFORMATDATA em lpGetInputFormats é NULL. O driver deve gravar o número de formatos de entrada compatíveis com o objeto VPE no membro dwNumFormats de DD_GETVPORTINPUTFORMATDATA. Após o retorno, o DirectDraw alocará esse número de estruturas DDPIXELFORMAT para passar a segunda chamada para DdVideoPortGetInputFormats.
  • Na segunda chamada, lpddpfFormat aponta para a matriz de estruturas DDPIXELFORMAT alocadas. O driver deve preencher cada estrutura para descrever cada formato de entrada compatível com o objeto VPE. O driver também deve retornar o número de formatos de entrada com suporte em dwNumFormats. Observe que o driver tem a garantia de que o buffer para o qual os pontos lpddpfFormat são grandes o suficiente para manter as informações de formato que estão sendo solicitadas.
Se o membro dwFlags da estrutura de DD_GETVPORTINPUTFORMATDATA for definido apenas como DDVPFORMAT_VIDEO, o driver deverá retornar apenas os formatos com suporte para os dados de vídeo normais. Se dwFlags for definido apenas como DDVPFORMAT_VBI, o driver deverá retornar apenas os formatos com suporte para os dados da VBI . Se dwFlags estiver definido como ambos os sinalizadores, o driver deverá retornar todos os formatos compatíveis com o objeto VPE.

Requisitos

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

Confira também

DDPIXELFORMAT

DD_GETVPORTINPUTFORMATDATA