DXGKDDI_VIDPNTARGETMODESET_ACQUIREFIRSTMODEINFO Rückruffunktion (d3dkmddi.h)
Die pfnAcquireFirstModeInfo Funktion gibt einen Deskriptor des ersten Modus in einem angegebenen VidPN-Zielmodussatz zurück.
Syntax
DXGKDDI_VIDPNTARGETMODESET_ACQUIREFIRSTMODEINFO DxgkddiVidpntargetmodesetAcquirefirstmodeinfo;
NTSTATUS DxgkddiVidpntargetmodesetAcquirefirstmodeinfo(
[in] IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
[out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_TARGET_MODE ppFirstVidPnTargetModeInfo
)
{...}
Parameter
[in] hVidPnTargetModeSet
Ein Handle für ein VidPN-Zielmodus-Set-Objekt. Der Display-Miniporttreiber hat dieses Handle zuvor durch Aufrufen der pfnAcquireTargetModeSet- Funktion der DXGK_VIDPN_INTERFACE Schnittstelle abgerufen.
[out] ppFirstVidPnTargetModeInfo
Ein Zeiger auf eine Variable, die einen Zeiger auf eine D3DKMDT_VIDPN_TARGET_MODE Struktur empfängt. Die Struktur enthält eine Vielzahl von Informationen zum Zielmodus, einschließlich der ID- und Videosignaleigenschaften.
Rückgabewert
Die pfnAcquireFirstModeInfo Funktion gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_SUCCESS | Die Funktion war erfolgreich. |
| STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET | Das in hVidPnTargetModeSet bereitgestellte Handle war ungültig. |
Bemerkungen
Wenn Sie die D3DKMDT_VIDPN_TARGET_MODE-Struktur verwendet haben, müssen Sie die Struktur freigeben, indem Sie pfnReleaseModeInfoaufrufen.
Sie können alle Modi aufzählen, die zu einem VidPN-Zielmodus-Set-Objekt gehören, indem Sie pfnAcquireFirstModeInfo aufrufen und dann eine Abfolge von Aufrufen an pfnAcquireNextModeInfo.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| Zielplattform- | Desktop |
| Header- | d3dkmddi.h (einschließlich D3dkmddi.h) |
| IRQL- | PASSIVE_LEVEL |