Compartilhar via

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

  • Artigo

A função de retorno de chamada DdVideoPortGetOutputFormats determina os formatos de saída aos quais o objeto VPE dá suporte.

Sintaxe

PDD_VPORTCB_GETOUTPUTFORMATS PddVportcbGetoutputformats;

DWORD PddVportcbGetoutputformats(
  PDD_GETVPORTOUTPUTFORMATDATA unnamedParam1
)
{...}

Parâmetros

unnamedParam1

Aponta para uma estrutura DD_GETVPORTOUTPUTFORMATDATA que contém as informações necessárias para o driver retornar os formatos de saída aos quais o objeto VPE dá suporte.

Valor retornado

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

Comentários

Os drivers DirectDraw que dão suporte à VPE devem implementar DdVideoPortGetOutputFormats

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

  • Na primeira chamada, o membro lpddpfOutputFormats da estrutura DD_GETVPORTOUTPUTFORMATDATA em lpGetOutputFormats é NULL. O driver deve gravar o número de formatos de saída aos quais o objeto VPE dá suporte no membro dwNumFormats do DD_GETVPORTOUTPUTFORMATDATA. Após o retorno, o DirectDraw alocará esse número de estruturas DDPIXELFORMAT para passar a segunda chamada para DdVideoPortGetOutputFormats.
  • Na segunda chamada, lpddpfOutputFormats aponta para a matriz de estruturas DDPIXELFORMAT alocadas. O driver deve preencher cada estrutura com uma descrição de cada formato de saída que o objeto VPE pode gravar no buffer de quadros. O driver deve retornar apenas os formatos de saída aos quais ele dá suporte com base no formato de entrada dos dados de vídeo. O driver também deve retornar o número de formatos de saída com suporte em dwNumFormats. Observe que o driver tem a garantia de que o buffer para o qual lpddpfOutputFormats aponta é grande o suficiente para manter as informações de formato que estão sendo solicitadas.
Se o membro dwFlags de DD_GETVPORTOUTPUTFORMATDATA for definido apenas como DDVPFORMAT_VIDEO, o driver deverá retornar apenas os formatos de saída com suporte para dados de vídeo normais. Se dwFlags for definido apenas como DDVPFORMAT_VBI, o driver deverá retornar apenas os formatos com suporte para dados 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_GETVPORTOUTPUTFORMATDATA