Freigeben über

DXGKDDI_GETNODEMETADATA Rückruffunktion (d3dkmddi.h)

  • Artikel

Aus einem bereitgestellten Adapterhandle gibt DXGKDDI_GETNODEMETADATA die Metadaten einer Engine auf einem angegebenen GPU-Knoten zurück.

Syntax

DXGKDDI_GETNODEMETADATA DxgkddiGetnodemetadata;

NTSTATUS DxgkddiGetnodemetadata(
  [in] IN_CONST_HANDLE hAdapter,
       UINT NodeOrdinalAndAdapterIndex,
       OUT_PDXGKARG_GETNODEMETADATA pGetNodeMetadata
)
{...}

Parameter

[in] hAdapter

[in] Ein Handle, das eine Grafikkarte identifiziert. Dxgkrnl hat dieses Handle zuvor für den Anzeige-Miniporttreiber (KMD) im DxgkInterface-Parameter der DxgkDdiStartDevice-Funktion bereitgestellt.

NodeOrdinalAndAdapterIndex

[in] Ein Index eines Knotens, für den Engine-Informationen abgerufen werden. Dieser Knoten befindet sich innerhalb des physischen Adapters, der durch den hAdapter-Parameter definiert wird.

pGetNodeMetadata

[out] Zeiger auf eine DXGKARG_GETNODEMETADATA-Struktur , in der KMD die Metadaten der von NodeOrdinal angegebenen Engine zurückgibt.

Beachten Sie, dass die DXGKARG_GETNODEMETADATA-Struktur als DXGK_NODEMETADATA-Struktur deklariert wird.

Rückgabewert

Gibt einen der folgenden Werte zurück:

Rückgabecode Beschreibung
STATUS_SUCCESS DxgkDdiGetNodeMetadata hat die Engine-Informationen erfolgreich abgerufen.
STATUS_INVALID_PARAMETER Der Parameter hAdapter oder pGetNodeMetadata ist ungültig, oder NodeOrdinal ist größer oder gleich der Anzahl der Knoten auf dem Adapter.

Wenn die Parameter hAdapter und pGetNodeMetadata gültig sind und NodeOrdinal einen Wert im Bereich von 0 bis (Anzahl der Knoten – 1) aufweist, müssen alle Aufrufe dieser Funktion erfolgreich sein.

Hinweise

KMD legt die Bits für jedes Feature fest, das vom angegebenen GPU-Knoten unterstützt wird. Mit dem Betriebssystem kann UMD nur die Metadatenfunktionen verwenden, für die KMD Unterstützung meldet.

WDDM 1.3 und höher müssen Anzeige-Miniporttreiber (KMDs) DXGKDDI_GETNODEMETADATA implementieren.

Weitere Informationen zum Implementieren dieser Funktion finden Sie unter Aufzählen von GPU-Engine-Funktionen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8.1 (WDDM 1.3)
Unterstützte Mindestversion (Server) Windows Server 2012 R2
Zielplattform Desktop
Kopfzeile d3dkmddi.h (einschließlich D3dkmddi.h)
IRQL PASSIVE_LEVEL

Weitere Informationen

DXGK_NODEMETADATA

DxgkDdiStartDevice