DXGKDDI_VIDPN_GETTOPOLOGY Rückruffunktion (d3dkmddi.h)
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 |