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

  • Статья

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

Синтаксис

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 (включая Wdm.h)