DXGKDDI_VIDPNTARGETMODESET_ACQUIREPINNEDMODEINFO Rückruffunktion (d3dkmddi.h)
Die pfnAcquirePinnedModeInfo-Funktion gibt einen Deskriptor des angehefteten Modus in einem angegebenen VidPN-Zielmodussatz zurück.
Syntax
DXGKDDI_VIDPNTARGETMODESET_ACQUIREPINNEDMODEINFO DxgkddiVidpntargetmodesetAcquirepinnedmodeinfo;
NTSTATUS DxgkddiVidpntargetmodesetAcquirepinnedmodeinfo(
[in] IN_CONST_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
[out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_TARGET_MODE ppPinnedVidPnTargetModeInfo
)
{...}
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.
[out] ppPinnedVidPnTargetModeInfo
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 über den angehefteten Modus, einschließlich seiner ID- und Videosignaleigenschaften. Wenn der von hVidPnTargetModeSet identifizierte Zielmodussatz keinen angehefteten Modus aufweist, erhält diese Variable einen NULL-Zeiger .
Rückgabewert
Die PfnAcquirePinnedModeInfo-Funktion gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_SUCCESS | Die Funktion ist erfolgreich, indem sie eine der folgenden Aktionen ausführt: 1. Festlegen von ppPinnedVidPnTargetModeInfo auf die Adresse D3DKMDT_VIDPN_TARGET_MODE Struktur, die den angehefteten Modus beschreibt. 2. Festlegen von ppPinnedVidPnTargetModeInfo auf NULL, um anzugeben, dass der festgelegte Zielmodus keinen angehefteten Modus aufweist. |
| 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.
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 |