DXGKDDI_VIDPNTARGETMODESET_ACQUIRENEXTMODEINFO Rückruffunktion (d3dkmddi.h)
Die pfnAcquireNextModeInfo-Funktion gibt einen Deskriptor des nächsten Modus in einem angegebenen VidPN-Zielmodussatz im aktuellen Modus zurück.
Syntax
DXGKDDI_VIDPNTARGETMODESET_ACQUIRENEXTMODEINFO DxgkddiVidpntargetmodesetAcquirenextmodeinfo;
NTSTATUS DxgkddiVidpntargetmodesetAcquirenextmodeinfo(
[in] IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
[in] IN_CONST_PD3DKMDT_VIDPN_TARGET_MODE_CONST pVidPnTargetModeInfo,
[out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_TARGET_MODE ppNextVidPnTargetModeInfo
)
{...}
Parameter
[in] hVidPnTargetModeSet
Ein Handle für ein VidPN-Zielmodus-Setobjekt. Der Anzeigeminiporttreiber hat dieses Handle zuvor durch Aufrufen der PfnAcquireTargetModeSet-Funktion der DXGK_VIDPN_INTERFACE-Schnittstelle abgerufen.
[in] pVidPnTargetModeInfo
Ein Zeiger auf eine D3DKMDT_VIDPN_TARGET_MODE Struktur, die den aktuellen Modus beschreibt. Der Anzeigeminiporttreiber hat diesen Zeiger zuvor durch Aufrufen von pfnAcquireFirstModeInfo oder pfnAcquireNextModeInfo abgerufen.
[out] ppNextVidPnTargetModeInfo
Ein Zeiger auf eine Variable, die einen Zeiger auf eine D3DKMDT_VIDPN_TARGET_MODE Struktur empfängt, die den nächsten Modus beschreibt.
Rückgabewert
Die PfnAcquireNextModeInfo-Funktion gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_SUCCESS | Die Funktion wurde erfolgreich ausgeführt. |
| STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET | Das in hVidPnTargetModeSet angegebene Handle war ungültig. |
Hinweise
Wenn Sie die Verwendung der D3DKMDT_VIDPN_TARGET_MODE-Struktur abgeschlossen haben, müssen Sie die Struktur freigeben, indem Sie pfnReleaseModeInfo aufrufen.
Sie können alle Modi auflisten, die zu einem bestimmten Zielmodussatzobjekt gehören, indem Sie pfnAcquireFirstModeInfo aufrufen und dann eine Sequenz von Aufrufen von pfnAcquireNextModeInfo ausführen.
Der D3DKMDT_HVIDPNTARGETMODESET 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 |