IOMMU_QUERY_INPUT_MAPPINGS fonction de rappel (wdm.h)

Article
02/07/2025

Tente de trouver des ID de mappage d’entrée qui sont valides pour l’appareil donné et remplissent la mémoire tampon fournie avec ces ID.

Syntaxe

IOMMU_QUERY_INPUT_MAPPINGS IommuQueryInputMappings;

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

Paramètres

[_In_] PhysicalDeviceObject

Pointeur vers l’objet d’appareil physique (PDO) dans la pile d’appareils.

[_Inout_] Buffer

Pointeur vers la mémoire tampon du type INPUT_MAPPING_ELEMENT rempli avec les ID de mappage d’entrée.

[_In_] BufferLength

Longueur de la mémoire tampon pointée par tampon.

[_Out_opt] ReturnLength

Optionnel. Pointeur pour stocker la quantité de données écrites (ou les données qui seraient écrites si une mémoire tampon de taille suffisante a été fournie).

Valeur de retour

Retournez STATUS_SUCCESS si l’opération réussit. Sinon, retournez un code d’erreur de valeurs NTSTATUS approprié. Pour plus d’informations, consultez valeurs NTSTATUS. Les valeurs possibles sont les suivantes :

Code d’erreur	Description
STATUS_BUFFER_TOO_SMALL	La mémoire tampon fournie est de taille insuffisante.
STATUS_UNSUCCESSFUL	La demande ne peut pas être satisfaite.
STATUS_SUCCESS	La mémoire tampon a été remplie correctement.

Remarques

Si la mémoire tampon est de longueur insuffisante, aucun ID n’est écrit et ReturnLength (s’il est fourni) est rempli avec la taille de mémoire tampon requise.

Cette routine est actuellement prise en charge uniquement sur les systèmes ARM64.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10, version 1803
d’en-tête	wdm.h (include Wdm.h)

Partager via