DXGKDDI_GETNODEMETADATA Rückruffunktion (d3dkmddi.h)
Von einem bereitgestellten Adapterhandle gibt DXGKDDI_GETNODEMETADATA die Metadaten eines Moduls 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, der einen Anzeigeadapter identifiziert. Dxgkrnl- zuvor dieses Handle für den Miniporttreiber (Display Miniport Driver, KMD) im DxgkInterface Parameter des DxgkDdiStartDevice-Funktion bereitgestellt.
NodeOrdinalAndAdapterIndex
[in] Ein Index eines Knotens, für den Modulinformationen abgerufen werden. Dieser Knoten befindet sich innerhalb des physischen Adapters, der vom hAdapter Parameter definiert wird.
pGetNodeMetadata
[out] Zeiger auf eine DXGKARG_GETNODEMETADATA Struktur, in der KMD die Metadaten des Moduls zurückgibt, das durch NodeOrdinalangegeben wird.
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 die Modulinformationen erfolgreich abgerufen. |
| STATUS_INVALID_PARAMETER | Der hAdapter- oder pGetNodeMetadata- Parameter ist ungültig, oder NodeOrdinal- größer oder gleich der Anzahl der Knoten auf dem Adapter ist. |
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.
Bemerkungen
KMD legt die Bits für jedes Feature fest, das der angegebene GPU-Knoten unterstützt. Das Betriebssystem ermöglicht UMD, nur die Metadatenfunktionen zu verwenden, für die KMD Berichte unterstützen.
WDDM 1.3 und höher display miniport drivers (KMDs) müssen DXGKDDI_GETNODEMETADATAimplementieren.
Weitere Informationen zum Implementieren dieser Funktion finden Sie unter Enumerating GPU Engine Capabilities.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8.1 (WDDM 1.3) |
| mindestens unterstützte Server- | Windows Server 2012 R2 |
| Zielplattform- | Desktop |
| Header- | d3dkmddi.h (einschließlich D3dkmddi.h) |
| IRQL- | PASSIVE_LEVEL |