DXGKDDI_VIDPN_ACQUIRETARGETMODESET Rückruffunktion (d3dkmddi.h)
Die pfnAcquireTargetModeSet-Funktion gibt ein Handle an ein bestimmtes Zielmodus-Setobjekt zurück, das in einem angegebenen VidPN-Objekt enthalten ist.
Syntax
DXGKDDI_VIDPN_ACQUIRETARGETMODESET DxgkddiVidpnAcquiretargetmodeset;
NTSTATUS DxgkddiVidpnAcquiretargetmodeset(
[in] IN_CONST_D3DKMDT_HVIDPN hVidPn,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
[out] OUT_PD3DKMDT_HVIDPNTARGETMODESET phVidPnTargetModeSet,
[out] DEREF_OUT_CONST_PPDXGK_VIDPNTARGETMODESET_INTERFACE ppVidPnTargetModeSetInterface
)
{...}
Parameter
[in] hVidPn
Ein Handle für ein VidPN-Objekt. Der VidPN-Manager hat dieses Handle zuvor für den Anzeige-Miniporttreiber bereitgestellt, indem er DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn oder DxgkDdiRecommendFunctionalVidPn aufgerufen hat.
[in] VidPnTargetId
Eine ganze Zahl, die eines der dem VidPN-Objekt zugeordneten Videoziele identifiziert.
[out] phVidPnTargetModeSet
Ein Zeiger auf eine Variable, die ein Handle für das angeforderte Zielmodus-Setobjekt empfängt.
[out] ppVidPnTargetModeSetInterface
Ein Zeiger auf eine Variable, die einen Zeiger auf eine DXGK_VIDPNTARGETMODESET_INTERFACE-Struktur empfängt. Die -Struktur enthält Zeiger auf Funktionen, die der Anzeige-Miniporttreiber aufrufen kann, um das Zielmodus-Setobjekt zu überprüfen und zu ändern.
Rückgabewert
Die pfnAcquireTargetModeSet-Funktion gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_SUCCESS | Die Funktion wurde erfolgreich ausgeführt. |
| STATUS_GRAPHICS_INVALID_VIDPN | Das in hVidPn angegebene Handle war ungültig. |
| STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET | Der in VidPnTargetId angegebene Bezeichner war ungültig. |
Hinweise
VidPN-Zielbezeichner werden vom Anzeige-Miniporttreiber zugewiesen. DxgkDdiQueryChildRelations, das vom Anzeigeminiporttreiber implementiert wird, gibt ein Array von DXGK_CHILD_DESCRIPTOR-Strukturen zurück, von denen jede einen Bezeichner enthält.
Wenn Sie die Verwendung des Objekthandles für das Festlegen des Zielmodus abgeschlossen haben, müssen Sie das Handle freigeben, indem Sie pfnReleaseTargetModeSet aufrufen. Zielmodus-Set-Objekte werden gezählt. Wenn Sie also ein Handle mehrmals abrufen, müssen Sie es genauso oft freigeben.
Die Lebensdauer der in ppVidPnTargetModeSetInterface zurückgegebenen DXGK_VIDPNTARGETMODESET_INTERFACE-Struktur gehört dem Betriebssystem. Mit diesem Besitzschema kann das Betriebssystem zur Laufzeit zu neueren Implementierungen wechseln, ohne clients der Schnittstelle zu unterbrechen.
Der D3DDDI_VIDEO_PRESENT_TARGET_ID Datentyp ist in D3dukmdt.h definiert.
Die Datentypen D3DKMDT_HVIDPN und D3DKMDT_HVIDPNTARGETMODESET sind 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 |