DXGKDDI_VIDPN_GETTOPOLOGY Rückruffunktion (d3dkmddi.h)

  • Artikel

Die pfnGetTopology-Funktion gibt ein Handle für 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 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.

[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 Anzeige-Miniporttreiber aufrufen kann, um das VidPN-Topologieobjekt zu überprüfen und zu ändern.

Rückgabewert

Die pfnGetTopology-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.

Hinweise

Der Anzeige-Miniporttreiber muss das Handle, das er in phVidPnTopology empfängt, nicht freigeben.

Die Lebensdauer der in ppVidPnTopologyInterface zurückgegebenen DXGK_VIDPNTOPOLOGY_INTERFACE-Struktur gehört dem Betriebssystem. Mit diesem Besitzschema kann das Betriebssystem zur Laufzeit zu neueren Implementierungen migrieren, ohne clients der Schnittstelle zu unterbrechen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista
Zielplattform Desktop
Kopfzeile d3dkmddi.h (einschließlich D3dkmddi.h)
IRQL PASSIVE_LEVEL

Weitere Informationen

DXGK_VIDPNTOPOLOGY_INTERFACE

VidPN-Topologieschnittstelle