IOMMU_QUERY_INPUT_MAPPINGS Rückruffunktion (wdm.h)

Versucht, Eingabezuordnungs-IDs zu finden, die für das angegebene Gerät gültig sind, und den bereitgestellten Puffer mit diesen IDs aufzufüllen.

Syntax

IOMMU_QUERY_INPUT_MAPPINGS IommuQueryInputMappings;

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

Parameter

[_In_] PhysicalDeviceObject

Ein Zeiger auf das objekt des physischen Geräts (PDO) im Gerätestapel.

[_Inout_] Buffer

Ein Zeiger auf den Puffer des Typs INPUT_MAPPING_ELEMENT , der mit den Eingabezuordnungs-IDs aufgefüllt wird.

[_In_] BufferLength

Die Länge des Puffers, auf den buffer verweist.

[_Out_opt] ReturnLength

Optional. Ein Zeiger zum Speichern der Menge der geschriebenen Daten (oder der Daten, die geschrieben werden würden, wenn ein Puffer mit ausreichender Größe bereitgestellt würde).

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls wird ein entsprechender Fehlercode für NTSTATUS-Werte zurückgegeben. Weitere Informationen finden Sie unter NTSTATUS-Werte. Mögliche Werte sind:

Hinweise

Wenn der Puffer eine unzureichende Länge aufweist, werden keine IDs geschrieben, und ReturnLength (sofern angegeben) wird mit der erforderlichen Puffergröße aufgefüllt.

Diese Routine wird derzeit nur auf ARM64-Systemen unterstützt.

Anforderungen