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 |