функция обратного вызова 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 (include D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |