IOMMU_QUERY_INPUT_MAPPINGS fonction de rappel (wdm.h)

  • Article

Tente de trouver des ID de mappage d’entrée qui sont valides pour l’appareil donné et de remplir 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 remplie avec les ID de mappage d’entrée.

[_In_] BufferLength

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

[_Out_opt] ReturnLength

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

Valeur retournée

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 incluent :

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 d’une 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 uniquement prise en charge sur les systèmes ARM64.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10 version 1803
En-tête wdm.h (inclure Wdm.h)