DXGKDDI_VIDPNSOURCEMODESET_ACQUIREFIRSTMODEINFO Rückruffunktion (d3dkmddi.h)
Die pfnAcquireFirstModeInfo-Funktion gibt einen Deskriptor des ersten Modus in einem angegebenen VidPN-Quellmodussatz zurück.
Syntax
DXGKDDI_VIDPNSOURCEMODESET_ACQUIREFIRSTMODEINFO DxgkddiVidpnsourcemodesetAcquirefirstmodeinfo;
NTSTATUS DxgkddiVidpnsourcemodesetAcquirefirstmodeinfo(
[in] IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
[out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_SOURCE_MODE ppFirstVidPnSourceModeInfo
)
{...}
Parameter
[in] hVidPnSourceModeSet
Ein Handle für ein VidPN-Quellmodus-Setobjekt. Der Anzeigeminiporttreiber hat dieses Handle zuvor durch Aufrufen der PfnAcquireSourceModeSet-Funktion der DXGK_VIDPN_INTERFACE-Schnittstelle abgerufen.
[out] ppFirstVidPnSourceModeInfo
Ein Zeiger auf eine Variable, die einen Zeiger auf eine D3DKMDT_VIDPN_SOURCE_MODE-Struktur empfängt. Die Struktur enthält eine Vielzahl von Informationen zum Modus, einschließlich der ID, des Typs und des Renderingformats.
Rückgabewert
Die PfnAcquireFirstModeInfo-Funktion gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_SUCCESS | Die Funktion wurde erfolgreich ausgeführt. |
| STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET | Das in hVidPnSourceModeSet angegebene Handle war ungültig. |
Hinweise
Wenn Sie die verwendung der D3DKMDT_VIDPN_SOURCE_MODE-Struktur abgeschlossen haben, müssen Sie die Struktur freigeben, indem Sie pfnReleaseModeInfo aufrufen.
Sie können alle Modi auflisten, die zu einem VidPN-Quellmodussatzobjekt gehören, indem Sie pfnAcquireFirstModeInfo aufrufen und dann eine Sequenz von Aufrufen von pfnAcquireNextModeInfo ausführen.
Der D3DKMDT_HVIDPNSOURCEMODESET Datentyp ist in D3dkmdt.h definiert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Zielplattform | Desktop |
| Kopfzeile | d3dkmddi.h (einschließlich D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |