PDD_VPORTCB_GETVPORTCONNECT Rückruffunktion (ddrawint.h)
Die DdVideoPortGetConnectInfo-Rückruffunktion gibt die Verbindungen zurück, die vom angegebenen VPE-Objekt unterstützt werden.
Syntax
PDD_VPORTCB_GETVPORTCONNECT PddVportcbGetvportconnect;
DWORD PddVportcbGetvportconnect(
PDD_GETVPORTCONNECTDATA unnamedParam1
)
{...}
Parameter
unnamedParam1
Verweist auf eine DD_GETVPORTCONNECTDATA-Struktur , die die Informationen enthält, die der Treiber zum Zurückgeben der Verbindungsdaten des VPE-Objekts benötigt.
Rückgabewert
DdVideoPortGetConnectInfo gibt einen der folgenden Rückrufcodes zurück:
Hinweise
DdVideoPortGetConnectInfo muss in DirectDraw-Treibern implementiert werden, die VPE unterstützen.
DirectDraw ruft DdVideoPortGetConnectInfo auf, um die Anzahl der Verbindungen abzurufen, die vom angegebenen VPE-Objekt unterstützt werden, und die Merkmale jeder Verbindung. DdVideoPortGetConnectInfo wird für das angegebene VPE-Objekt zweimal aufgerufen:
- Im ersten Aufruf ist der lpConnect-Member der DD_GETVPORTCONNECTDATA-Struktur in lpGetConnectNULL. Der Treiber sollte die Anzahl der Verbindungen schreiben, die das VPE-Objekt unterstützt, im dwNumEntries-Member von DD_GETVPORTCONNECTDATA. Nach der Rückgabe ordnet DirectDraw diese Anzahl von DDVIDEOPORTCONNECT-Strukturen zu, um den zweiten Aufruf von DdVideoPortGetConnectInfo zu übergeben.
- Im zweiten Aufruf zeigt lpConnect auf das Array der zugeordneten DDVIDEOPORTCONNECT-Strukturen . Der Treiber sollte jede Struktur ausfüllen, um jede Verbindung zu beschreiben, die das VPE-Objekt unterstützt. Der Treiber sollte auch die Anzahl der unterstützten Verbindungen in dwNumEntries zurückgeben. Beachten Sie, dass der Treiber garantiert, dass der Puffer, auf den lpConnect verweist, groß genug ist, um die angeforderten Verbindungsinformationen zu enthalten.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | ddrawint.h (einschließlich Winddi.h) |