Compartir a través de

PDD_VPORTCB_GETOUTPUTFORMATS función de devolución de llamada (ddrawint.h)

  • Artículo

La función de devolución de llamada DdVideoPortGetOutputFormats determina los formatos de salida que admite el objeto VPE.

Sintaxis

PDD_VPORTCB_GETOUTPUTFORMATS PddVportcbGetoutputformats;

DWORD PddVportcbGetoutputformats(
  PDD_GETVPORTOUTPUTFORMATDATA unnamedParam1
)
{...}

Parámetros

unnamedParam1

Apunta a una estructura de DD_GETVPORTOUTPUTFORMATDATA que contiene la información necesaria para que el controlador devuelva los formatos de salida que admite el objeto VPE.

Valor devuelto

DdVideoPortGetOutputFormats devuelve uno de los siguientes códigos de devolución de llamada:

Comentarios

Los controladores de DirectDraw que admiten VPE deben implementar DdVideoPortGetOutputFormats

DirectDraw llama a DdVideoPortGetOutputFormats para obtener el número de formatos de salida admitidos por el objeto VPE especificado y una descripción de cada formato. Se llama a DdVideoPortGetOutputFormats dos veces para el objeto VPE especificado:

  • En la primera llamada, el miembro lpddpfOutputFormats de la estructura de DD_GETVPORTOUTPUTFORMATDATA en lpGetOutputFormats es NULL. El controlador debe escribir el número de formatos de salida que admite el objeto VPE en el miembro dwNumFormats de DD_GETVPORTOUTPUTFORMATDATA. Tras la devolución, DirectDraw asignará este número de estructuras DDPIXELFORMAT para pasar la segunda llamada a DdVideoPortGetOutputFormats.
  • En la segunda llamada, lpddpfOutputFormats apunta a la matriz de estructuras DDPIXELFORMAT asignadas. El controlador debe rellenar cada estructura con una descripción de cada formato de salida que el objeto VPE puede escribir en el búfer de fotogramas. El controlador debe devolver solo los formatos de salida que admite en función del formato de entrada de los datos de vídeo. El controlador también debe devolver el número de formatos de salida admitidos en dwNumFormats. Tenga en cuenta que se garantiza que el búfer al que apunta lpddpfOutputFormats es lo suficientemente grande como para contener la información de formato que se solicita.
Si el miembro dwFlags de DD_GETVPORTOUTPUTFORMATDATA se establece solo en DDVPFORMAT_VIDEO, el controlador debe devolver solo los formatos de salida compatibles con los datos de vídeo normales. Si dwFlags se establece solo en DDVPFORMAT_VBI, el controlador debe devolver solo los formatos admitidos para los datos VBI . Si dwFlags se establece en ambas marcas, el controlador debe devolver todos los formatos admitidos por el objeto VPE .

Requisitos

   
Plataforma de destino Escritorio
Encabezado ddrawint.h (incluya Winddi.h)

Consulte también

DDPIXELFORMAT

DD_GETVPORTOUTPUTFORMATDATA