Compartir a través de

IOMMU_QUERY_INPUT_MAPPINGS función de devolución de llamada (wdm.h)

  • Artículo

Intenta buscar identificadores de asignación de entrada que son válidos para el dispositivo especificado y rellenar el búfer proporcionado con esos identificadores.

Sintaxis

IOMMU_QUERY_INPUT_MAPPINGS IommuQueryInputMappings;

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

Parámetros

[_In_] PhysicalDeviceObject

Puntero al objeto de dispositivo físico (PDO) de la pila de dispositivos.

[_Inout_] Buffer

Puntero al búfer del tipo INPUT_MAPPING_ELEMENT que se rellena con los identificadores de asignación de entrada.

[_In_] BufferLength

Longitud del búfer al que apunta buffer.

[_Out_opt] ReturnLength

Opcional. Puntero para almacenar la cantidad de datos escritos (o datos que se escribirían si se proporcionaba un búfer de tamaño suficiente).

Valor devuelto

Devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, devuelve un código de error de valores NTSTATUS adecuado. Para obtener más información, vea Valores NTSTATUS. Los valores posibles son:

Código de error Descripción
STATUS_BUFFER_TOO_SMALL El búfer proporcionado tiene un tamaño insuficiente.
STATUS_UNSUCCESSFUL No se puede satisfacer la solicitud.
STATUS_SUCCESS El búfer se ha rellenado correctamente.

Comentarios

Si el búfer es de longitud insuficiente, no se escribirán identificadores y ReturnLength (si se proporciona) se rellenará con el tamaño de búfer necesario.

Actualmente, esta rutina solo se admite en sistemas ARM64.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 1803
Encabezado wdm.h (incluya Wdm.h)