DXGKDDI_GETNODEMETADATA función de devolución de llamada (d3dkmddi.h)

Desde un identificador de adaptador proporcionado, DXGKDDI_GETNODEMETADATA devuelve los metadatos de un motor en un nodo de GPU especificado.

Sintaxis

DXGKDDI_GETNODEMETADATA DxgkddiGetnodemetadata;

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

Parámetros

[in] hAdapter

[in] Identificador que identifica un adaptador de pantalla. Dxgkrnl proporcionó anteriormente este identificador al controlador de minipuerto de pantalla (KMD) en el parámetro DxgkInterface de la función DxgkDdiStartDevice .

NodeOrdinalAndAdapterIndex

[in] Índice de un nodo para el que se obtiene información del motor. Este nodo está dentro del adaptador físico definido por el parámetro hAdapter .

pGetNodeMetadata

[out] Puntero a una estructura de DXGKARG_GETNODEMETADATA en la que KMD devuelve los metadatos del motor especificados por NodeOrdinal.

Tenga en cuenta que la estructura DXGKARG_GETNODEMETADATA se declara como una estructura de DXGK_NODEMETADATA .

Valor devuelto

Devuelve uno de los valores siguientes:

Código devuelto	Descripción
STATUS_SUCCESS	DxgkDdiGetNodeMetadata recuperó correctamente la información del motor.
STATUS_INVALID_PARAMETER	El parámetro hAdapter o pGetNodeMetadata no es válido, o NodeOrdinal es mayor o igual que el número de nodos del adaptador.

Si los parámetros hAdapter y pGetNodeMetadata son válidos y NodeOrdinal tiene un valor en el intervalo de 0 a (número de nodos - 1), todas las llamadas a esta función deben realizarse correctamente.

Comentarios

KMD establece los bits de cada característica que admite el nodo de GPU especificado. El sistema operativo permite a UMD usar solo las funcionalidades de metadatos compatibles con los informes de KMD.

WDDM 1.3 y controladores de minipuerto de pantalla posteriores deben implementar DXGKDDI_GETNODEMETADATA.

Para obtener más información sobre cómo implementar esta función, consulte Enumeración de funcionalidades del motor de GPU.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8.1 (WDDM 1.3)
Servidor mínimo compatible	Windows Server 2012 R2
Plataforma de destino	Escritorio
Encabezado	d3dkmddi.h (incluye D3dkmddi.h)
IRQL	PASSIVE_LEVEL

Consulte también

DXGK_NODEMETADATA

DxgkDdiStartDevice