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

Intenta buscar identificadores de asignación de entrada que son válidos para el dispositivo determinado 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 Búfer.

[_Out_opt] ReturnLength

Opcional. Puntero para almacenar la cantidad de datos escritos (o datos que se escribirían si se proporcionó 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 apropiado. Para obtener más información, vea valores NTSTATUS. Entre los valores posibles se incluyen:

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

Observaciones

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	Valor
cliente mínimo admitido	Windows 10, versión 1803
encabezado de	wdm.h (incluya Wdm.h)