PDD_VPORTCB_GETINPUTFORMATS Rückruffunktion (ddrawint.h)

Artikel
08/23/2023

Die DdVideoPortGetInputFormats-Rückruffunktion bestimmt die Eingabeformate, die das DirectDraw VPE-Objekt akzeptieren kann.

Syntax

PDD_VPORTCB_GETINPUTFORMATS PddVportcbGetinputformats;

DWORD PddVportcbGetinputformats(
  PDD_GETVPORTINPUTFORMATDATA unnamedParam1
)
{...}

Parameter

unnamedParam1

Verweist auf eine DD_GETVPORTINPUTFORMATDATA-Struktur , die die Informationen enthält, die für den Treiber erforderlich sind, um die Eingabeformate zurückzugeben, die das VPE-Objekt akzeptieren kann.

Rückgabewert

DdVideoPortGetInputFormats gibt einen der folgenden Rückrufcodes zurück:

Hinweise

DdVideoPortGetInputFormats muss in DirectDraw-Treibern implementiert werden, die VPE unterstützen.

DirectDraw ruft DdVideoPortGetInputFormats auf, um die Anzahl der Vom angegebenen VPE-Objekt unterstützten Eingabeformate und eine Beschreibung der einzelnen Formate abzurufen. DdVideoPortGetInputFormats wird für das angegebene VPE-Objekt zweimal aufgerufen:

Im ersten Aufruf ist das lpddpfFormat-Member der DD_GETVPORTINPUTFORMATDATA-Struktur bei lpGetInputFormatsNULL. Der Treiber sollte die Anzahl von Eingabeformaten, die das VPE-Objekt unterstützt, im dwNumFormats-Member von DD_GETVPORTINPUTFORMATDATA schreiben. Nach der Rückgabe weist DirectDraw diese Anzahl von DDPIXELFORMAT-Strukturen zu, die im zweiten Aufruf an DdVideoPortGetInputFormats übergeben werden sollen.
Beim zweiten Aufruf verweist lpddpfFormat auf das Array zugeordneter DDPIXELFORMAT-Strukturen. Der Treiber sollte jede Struktur ausfüllen, um jedes Eingabeformat zu beschreiben, das das VPE-Objekt unterstützt. Der Treiber sollte auch die Anzahl der unterstützten Eingabeformate in dwNumFormats zurückgeben. Beachten Sie, dass der Treiber garantiert, dass der Puffer, auf den lpddpfFormat verweist, groß genug ist, um die angeforderten Formatinformationen aufzunehmen.

Wenn der dwFlags-Member der DD_GETVPORTINPUTFORMATDATA-Struktur nur auf DDVPFORMAT_VIDEO festgelegt ist, sollte der Treiber nur die Formate zurückgeben, die für die normalen Videodaten unterstützt werden. Wenn dwFlags nur auf DDVPFORMAT_VBI festgelegt ist, sollte der Treiber nur die für die VBI-Daten unterstützten Formate zurückgeben. Wenn dwFlags auf beide Flags festgelegt ist, sollte der Treiber alle vom VPE-Objekt unterstützten Formate zurückgeben.

Anforderungen


Zielplattform	Desktop
Kopfzeile	ddrawint.h (include Winddi.h)

Weitere Informationen

DDPIXELFORMAT

DD_GETVPORTINPUTFORMATDATA

Freigeben über