функция обратного вызова 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 |