IOMMU_QUERY_INPUT_MAPPINGS funzione di callback (wdm.h)

Articolo
02/29/2024

Tenta di trovare gli ID di mapping di input validi per il dispositivo specificato e di popolare il buffer fornito con tali ID.

Sintassi

IOMMU_QUERY_INPUT_MAPPINGS IommuQueryInputMappings;

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

Parametri

[_In_] PhysicalDeviceObject

Puntatore all'oggetto dispositivo fisico (PDO) nello stack di dispositivi.

[_Inout_] Buffer

Puntatore al buffer del tipo INPUT_MAPPING_ELEMENT popolato con gli ID di mapping di input.

[_In_] BufferLength

Lunghezza del buffer a cui punta Buffer.

[_Out_opt] ReturnLength

facoltativo. Puntatore per archiviare la quantità di dati scritti (o dati che verrebbero scritti se è stato fornito un buffer di dimensioni sufficienti).

Valore restituito

Restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, restituire un codice di errore dei valori NTSTATUS appropriato. Per altre informazioni, vedere Valori NTSTATUS. I valori possibili sono:

Codice di errore	Descrizione
STATUS_BUFFER_TOO_SMALL	Il buffer fornito è di dimensioni insufficienti.
STATUS_UNSUCCESSFUL	La richiesta non può essere soddisfatta.
STATUS_SUCCESS	Il buffer è stato popolato correttamente.

Commenti

Se la lunghezza del buffer è insufficiente, non verrà scritto alcun ID e ReturnLength (se specificato) verrà popolato con le dimensioni del buffer necessarie.

Questa routine è attualmente supportata solo nei sistemi ARM64.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10, versione 1803
Intestazione	wdm.h (include Wdm.h)

Condividi tramite