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