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

Buffer 所指向之緩衝區的長度。

[_Out_opt] ReturnLength

選擇性。 指標，用來儲存寫入 (的數據量，或是提供足夠大小的緩衝區) 所寫入的數據。

傳回值

如果作業成功，則傳回STATUS_SUCCESS。 否則，傳回適當的NTSTATUS值錯誤碼。 如需詳細資訊，請參閱 NTSTATUS值。 可能的值包括：

錯誤碼 描述
STATUS_BUFFER_TOO_SMALL 提供的緩衝區大小不足。
STATUS_UNSUCCESSFUL 無法滿足要求。
STATUS_SUCCESS 緩衝區已正確填入。

備註

如果緩衝區長度不足，則不會寫入任何標識符，如果提供) ，則會填入所需的緩衝區大小，則不會寫入 ReturnLength (。

目前只有 ARM64 系統上支援此例程。

規格需求

需求 值
最低支援的用戶端 Windows 10 (版本 1803)
標頭 wdm.h (包含 Wdm.h)