функция обратного вызова DXGKDDI_GETNODEMETADATA (d3dkmddi.h)

  • Статья

Из предоставленного дескриптора адаптера DXGKDDI_GETNODEMETADATA возвращает метаданные подсистемы на указанном узле GPU.

Синтаксис

DXGKDDI_GETNODEMETADATA DxgkddiGetnodemetadata;

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

Параметры

[in] hAdapter

[in] Дескриптор, идентифицирующий видеоадаптер. Dxgkrnl ранее предоставлял этот дескриптор для драйвера мини-порта дисплея (KMD) в параметре DxgkInterface функции DxgkDdiStartDevice .

NodeOrdinalAndAdapterIndex

[in] Индекс узла, для которого получены сведения о подсистеме. Этот узел находится в физическом адаптере, определенном параметром hAdapter .

pGetNodeMetadata

[out] Указатель на структуру DXGKARG_GETNODEMETADATA , в которой KMD возвращает метаданные подсистемы, указанной NodeOrdinal.

Обратите внимание, что структура DXGKARG_GETNODEMETADATA объявлена как структура DXGK_NODEMETADATA .

Возвращаемое значение

Возвращает одно из следующих значений:

Код возврата Описание
STATUS_SUCCESS DxgkDdiGetNodeMetadata успешно извлек информацию о подсистеме.
STATUS_INVALID_PARAMETER Недопустимый параметр hAdapter или pGetNodeMetadata , или Значение NodeOrdinal больше или равно количеству узлов в адаптере.

Если параметры hAdapter и pGetNodeMetadata являются допустимыми, а NodeOrdinal имеет значение в диапазоне от 0 до (число узлов — 1), все вызовы этой функции должны быть успешными.

Комментарии

KMD задает биты для каждой функции, которую поддерживает указанный узел GPU. ОС позволяет UMD использовать только те возможности метаданных, которые поддерживаются kmd.

В WDDM 1.3 и более поздних версиях драйверы мини-портов (KMD) должны реализовывать DXGKDDI_GETNODEMETADATA.

Дополнительные сведения о реализации этой функции см. в разделе Перечисление возможностей обработчика GPU.

Требования

Требование Значение
Минимальная версия клиента Windows 8.1 (WDDM 1.3)
Минимальная версия сервера Windows Server 2012 R2
Целевая платформа Персональный компьютер
Верхняя часть d3dkmddi.h (включая D3dkmddi.h)
IRQL PASSIVE_LEVEL

См. также раздел

DXGK_NODEMETADATA

DxgkDdiStartDevice