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

Статья
02/07/2025

Пытается найти идентификаторы сопоставления входных данных, допустимые для данного устройства, и заполните предоставленный буфер этими идентификаторами.

Синтаксис

IOMMU_QUERY_INPUT_MAPPINGS IommuQueryInputMappings;

NTSTATUS IommuQueryInputMappings(
  [_In_]     PDEVICE_OBJECT PhysicalDeviceObject,
  [_Inout_]  PINPUT_MAPPING_ELEMENT Buffer,
  [_In_]     ULONG BufferLength,
  [_Out_opt] PULONG ReturnLength
)
{...}

Параметры

[_In_] PhysicalDeviceObject

Указатель на объект физического устройства (PDO) в стеке устройств.

[_Inout_] Buffer

Указатель на буфер типа INPUT_MAPPING_ELEMENT, заполненный идентификаторами сопоставления входных данных.

[_In_] BufferLength

Длина буфера, на которую указывает буфер.

[_Out_opt] ReturnLength

Необязательный. Указатель на хранение объема записанных данных (или данных, которые будут записаны, если буфер достаточного размера был предоставлен).

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

Возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае верните соответствующий код ошибки NTSTATUS. Дополнительные сведения см. в значения NTSTATUS. Возможные значения:

Код ошибки	Описание
STATUS_BUFFER_TOO_SMALL	Предоставленный буфер имеет недостаточный размер.
STATUS_UNSUCCESSFUL	Запрос не может быть удовлетворен.
STATUS_SUCCESS	Буфер заполнен правильно.

Замечания

Если буфер недостаточной длины, идентификаторы не будут записаны, и ReturnLength (если это указано) будет заполнено требуемым размером буфера.

Эта подпрограмма в настоящее время поддерживается только в системах ARM64.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10 версии 1803
заголовка	wdm.h (include Wdm.h)

Поделиться через