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 zu einem VidPN-Quellmodussatzobjekt. Der Display-Miniporttreiber 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 der ID, des Typs und des Renderingformats. Wenn der durch hVidPnSourceMode Set festgelegte Quellmodus 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 war erfolgreich, indem Sie eine der folgenden Aktionen ausführen: 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 festgelegte Quellmodus keinen angehefteten Modus aufweist. |
| STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET | Das in hVidPnSourceModeSet bereitgestellte Handle war ungültig. |
Bemerkungen
Wenn Sie die D3DKMDT_VIDPN_SOURCE_MODE Struktur verwendet haben, müssen Sie die Struktur freigeben, indem Sie pfnReleaseModeInfoaufrufen.
Der D3DKMDT_HVIDPNSOURCEMODESET Datentyp wird in D3dkmdt.hdefiniert.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| Zielplattform- | Desktop |
| Header- | d3dkmddi.h (einschließlich D3dkmddi.h) |
| IRQL- | PASSIVE_LEVEL |