DXGKDDI_VIDPN_ACQUIRESOURCEMODESET Rückruffunktion (d3dkmddi.h)
Die pfnAcquireSourceModeSet-Funktion gibt ein Handle für ein bestimmtes Quellmodussatzobjekt zurück, das in einem angegebenen VidPN-Objekt enthalten ist.
Syntax
DXGKDDI_VIDPN_ACQUIRESOURCEMODESET DxgkddiVidpnAcquiresourcemodeset;
NTSTATUS DxgkddiVidpnAcquiresourcemodeset(
[in] IN_CONST_D3DKMDT_HVIDPN hVidPn,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
[out] OUT_PD3DKMDT_HVIDPNSOURCEMODESET phVidPnSourceModeSet,
[out] DEREF_OUT_CONST_PPDXGK_VIDPNSOURCEMODESET_INTERFACE ppVidPnSourceModeSetInterface
)
{...}
Parameter
[in] hVidPn
Ein Handle für ein VidPN-Objekt. Der VidPN-Manager hat dieses Handle zuvor für den Anzeigeminiporttreiber bereitgestellt, indem er DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn oder DxgkDdiRecommendFunctionalVidPn aufgerufen hat.
[in] VidPnSourceId
Eine ganze Zahl, die eine der vorhandenen Videoquellen identifiziert, die dem VidPN-Objekt zugeordnet sind.
[out] phVidPnSourceModeSet
Ein Zeiger auf eine Variable, die ein Handle für das angeforderte Quellmodus-Setobjekt empfängt.
[out] ppVidPnSourceModeSetInterface
Ein Zeiger auf eine Variable, die einen Zeiger auf eine DXGK_VIDPNSOURCEMODESET_INTERFACE-Struktur empfängt. Die Struktur enthält Zeiger auf Funktionen, die der Anzeigeminiporttreiber aufrufen kann, um das Quellmodussatzobjekt zu überprüfen und zu ändern.
Rückgabewert
Die PfnAcquireSourceModeSet-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_SOURCE | Der in VidPnSourceId angegebene Bezeichner war ungültig. |
Hinweise
VidPN-Quellbezeichner werden vom Betriebssystem zugewiesen. DxgkDdiStartDevice, das vom Anzeigeminiporttreiber implementiert wurde, gibt die Anzahl N der vom Grafikkarte unterstützten Videoquellen zurück. Dann weist das Betriebssystem die Bezeichner 0, 1, 2, ... N - 1.
Wenn Sie die Verwendung des Objekthandles für den Quellmodussatz abgeschlossen haben, müssen Sie das Handle freigeben, indem Sie pfnReleaseSourceModeSet aufrufen. Quellmodussatzobjekte werden referenzgezählt. Wenn Sie also ein Handle mehrmals abrufen, müssen Sie es genauso oft freigeben.
Die Lebensdauer der DXGK_VIDPNSOURCEMODESET_INTERFACE Struktur, die in ppVidPnSourceModeSetInterface zurückgegeben wird, 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_SOURCE_ID Datentyp ist in D3dukmdt.h definiert.
Die Datentypen D3DKMDT_HVIDPN und D3DKMDT_HVIDPNSOURCEMODESET werden 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 |