Compartir a través de

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

  • Artículo

La función de devolución de llamada DdVideoPortGetInputFormats determina los formatos de entrada que el objeto VPE de DirectDraw puede aceptar.

Sintaxis

PDD_VPORTCB_GETINPUTFORMATS PddVportcbGetinputformats;

DWORD PddVportcbGetinputformats(
  PDD_GETVPORTINPUTFORMATDATA unnamedParam1
)
{...}

Parámetros

unnamedParam1

Apunta a una estructura de DD_GETVPORTINPUTFORMATDATA que contiene la información necesaria para que el controlador devuelva los formatos de entrada que puede aceptar el objeto VPE.

Valor devuelto

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

Comentarios

DdVideoPortGetInputFormats debe implementarse en controladores de DirectDraw que admitan VPE.

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

  • En la primera llamada, el miembro lpddpfFormat de la estructura de DD_GETVPORTINPUTFORMATDATA en lpGetInputFormats es NULL. El controlador debe escribir el número de formatos de entrada que admite el objeto VPE en el miembro dwNumFormats de DD_GETVPORTINPUTFORMATDATA. Tras la devolución, DirectDraw asignará este número de estructuras DDPIXELFORMAT para pasar la segunda llamada a DdVideoPortGetInputFormats.
  • En la segunda llamada, lpddpfFormat apunta a la matriz de estructuras DDPIXELFORMAT asignadas. El controlador debe rellenar cada estructura para describir cada formato de entrada que admita el objeto VPE. El controlador también debe devolver el número de formatos de entrada admitidos en dwNumFormats. Tenga en cuenta que se garantiza que el búfer al que apunta lpddpfFormat es lo suficientemente grande como para contener la información de formato que se solicita.
Si el miembro dwFlags de la estructura de DD_GETVPORTINPUTFORMATDATA solo se establece en DDVPFORMAT_VIDEO, el controlador solo debe devolver los formatos admitidos para los datos de vídeo normales. Si dwFlags solo se establece en DDVPFORMAT_VBI, el controlador solo debe devolver esos formatos admitidos para los datos de 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_GETVPORTINPUTFORMATDATA