DXGKDDI_VIDPN_GETTOPOLOGY Rückruffunktion (d3dkmddi.h)
Die pfnGetTopology--Funktion gibt ein Handle an das VidPN-Topologieobjekt zurück, das in einem angegebenen VidPN-Objekt enthalten ist.
Syntax
DXGKDDI_VIDPN_GETTOPOLOGY DxgkddiVidpnGettopology;
NTSTATUS DxgkddiVidpnGettopology(
[in] IN_CONST_D3DKMDT_HVIDPN hVidPn,
[out] OUT_PD3DKMDT_HVIDPNTOPOLOGY phVidPnTopology,
[out] DEREF_OUT_CONST_PPDXGK_VIDPNTOPOLOGY_INTERFACE ppVidPnTopologyInterface
)
{...}
Parameter
[in] hVidPn
Ein Handle zu einem VidPN-Objekt. Der VidPN-Manager hat diesem Handle zuvor den Miniporttreiber angezeigt, indem er DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPnoder DxgkDdiRecommendFunctionalVidPnaufruft.
[out] phVidPnTopology
Ein Zeiger auf eine Variable, die ein Handle für das VidPN-Topologieobjekt empfängt.
[out] ppVidPnTopologyInterface
Ein Zeiger auf eine Variable, die einen Zeiger auf eine DXGK_VIDPNTOPOLOGY_INTERFACE Struktur empfängt. Die Struktur enthält Zeiger auf Funktionen, die der Anzeigeminiporttreiber aufrufen kann, um das VidPN-Topologieobjekt zu prüfen und zu ändern.
Rückgabewert
Die pfnGetTopology Funktion gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_SUCCESS | Die Funktion war erfolgreich. |
| STATUS_GRAPHICS_INVALID_VIDPN | Der in hVidPn bereitgestellte Handle war ungültig. |
Bemerkungen
Der Miniporttreiber der Anzeige muss den Handle, den er in phVidPnTopology-empfängt, nicht freigeben.
Die Lebensdauer der DXGK_VIDPNTOPOLOGY_INTERFACE Struktur, die in ppVidPnTopologyInterface- zurückgegeben wird, gehört dem Betriebssystem. Mit diesem Besitzerschema kann das Betriebssystem zur Laufzeit zu neueren Implementierungen migrieren, ohne clients der Schnittstelle zu unterbrechen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| Zielplattform- | Desktop |
| Header- | d3dkmddi.h (einschließlich D3dkmddi.h) |
| IRQL- | PASSIVE_LEVEL |