DXGKDDI_VIDPNSOURCEMODESET_ACQUIREPINNEDMODEINFO Rückruffunktion (d3dkmddi.h)
Die pfnAcquirePinnedModeInfo-Funktion gibt einen Deskriptor des angehefteten Modus in einem angegebenen VidPN-Quellmodussatz zurück.
Syntax
DXGKDDI_VIDPNSOURCEMODESET_ACQUIREPINNEDMODEINFO DxgkddiVidpnsourcemodesetAcquirepinnedmodeinfo;
NTSTATUS DxgkddiVidpnsourcemodesetAcquirepinnedmodeinfo(
[in] IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
[out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_SOURCE_MODE ppPinnedVidPnSourceModeInfo
)
{...}
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] ppPinnedVidPnSourceModeInfo
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 angehefteten Modus, einschließlich ID, Typ und Renderingformat. Wenn der von hVidPnSourceModeSet identifizierte Quellmodussatz keinen angehefteten Modus aufweist, empfängt 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 ppPinnedVidPnSourceModeInfo auf die Adresse D3DKMDT_VIDPN_SOURCE_MODE Struktur, die den angehefteten Modus beschreibt. 2. Festlegen von ppPinnedVidPnSourceModeInfo auf NULL, um anzugeben, dass der Quellmodussatz keinen angehefteten Modus aufweist. |
| 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.
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 |