IOMMU_QUERY_INPUT_MAPPINGS Rückruffunktion (wdm.h)

Artikel
02/29/2024

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:

Fehlercode	BESCHREIBUNG
STATUS_BUFFER_TOO_SMALL	Der bereitgestellte Puffer ist nicht ausreichend groß.
STATUS_UNSUCCESSFUL	Die Anforderung kann nicht erfüllt werden.
STATUS_SUCCESS	Der Puffer wurde ordnungsgemäß aufgefüllt.

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

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1803
Kopfzeile	wdm.h (wdm.h einschließen)

Freigeben über