PDD_VPORTCB_GETOUTPUTFORMATS Rückruffunktion (ddrawint.h)

Artikel
08/23/2023

Die DdVideoPortGetOutputFormats-Rückruffunktion bestimmt die Ausgabeformate, die das VPE-Objekt unterstützt.

Syntax

PDD_VPORTCB_GETOUTPUTFORMATS PddVportcbGetoutputformats;

DWORD PddVportcbGetoutputformats(
  PDD_GETVPORTOUTPUTFORMATDATA unnamedParam1
)
{...}

Parameter

unnamedParam1

Verweist auf eine DD_GETVPORTOUTPUTFORMATDATA-Struktur , die die Informationen enthält, die der Treiber benötigt, um die vom VPE-Objekt unterstützten Ausgabeformate zurückzugeben.

Rückgabewert

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

Hinweise

DirectDraw-Treiber, die VPE unterstützen, müssen DdVideoPortGetOutputFormats implementieren.

DirectDraw ruft DdVideoPortGetOutputFormats auf, um die Anzahl der Ausgabeformate abzurufen, die vom angegebenen VPE-Objekt unterstützt werden, sowie eine Beschreibung der einzelnen Formate. DdVideoPortGetOutputFormats wird für das angegebene VPE-Objekt zweimal aufgerufen:

Im ersten Aufruf ist der lpddpfOutputFormats-Member der DD_GETVPORTOUTPUTFORMATDATA-Struktur bei lpGetOutputFormatsNULL. Der Treiber sollte die Anzahl von Ausgabeformaten, die das VPE-Objekt unterstützt, in den dwNumFormats-Member von DD_GETVPORTOUTPUTFORMATDATA schreiben. Nach der Rückgabe ordnet DirectDraw diese Anzahl von DDPIXELFORMAT-Strukturen zu, um den zweiten Aufruf von DdVideoPortGetOutputFormats zu übergeben.
Im zweiten Aufruf zeigt lpddpfOutputFormats auf das Array der zugeordneten DDPIXELFORMAT-Strukturen. Der Treiber sollte jede Struktur mit einer Beschreibung jedes Ausgabeformats füllen, das das VPE-Objekt in den Framepuffer schreiben kann. Der Treiber sollte nur die Ausgabeformate zurückgeben, die er basierend auf dem Eingabeformat der Videodaten unterstützt. Der Treiber sollte auch die Anzahl der unterstützten Ausgabeformate in dwNumFormats zurückgeben. Beachten Sie, dass der Treiber garantiert, dass der Puffer, auf den lpddpfOutputFormats verweist, groß genug ist, um die angeforderten Formatinformationen zu speichern.

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

Anforderungen


Zielplattform	Desktop
Kopfzeile	ddrawint.h (einschließlich Winddi.h)

Weitere Informationen

DDPIXELFORMAT

DD_GETVPORTOUTPUTFORMATDATA

Share via