IOMMU_QUERY_INPUT_MAPPINGS função de retorno de chamada (wdm.h)
Tenta localizar IDs de mapeamento de entrada que são válidas para o dispositivo especificado e preencher o buffer fornecido com essas IDs.
Sintaxe
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
Um ponteiro para o PDO (objeto de dispositivo físico) na pilha do dispositivo.
[_Inout_] Buffer
Um ponteiro para o buffer do tipo INPUT_MAPPING_ELEMENT preenchido com as IDs de mapeamento de entrada.
[_In_] BufferLength
O comprimento do buffer apontado por Buffer.
[_Out_opt] ReturnLength
Opcional. Um ponteiro para armazenar a quantidade de dados gravados (ou dados que seriam gravados se um buffer de tamanho suficiente fosse fornecido).
Retornar valor
Retornar STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, retorne um código de erro de valores NTSTATUS apropriado. Para obter mais informações, consulte Valores NTSTATUS. Os valores possíveis incluem:
Código do erro | Descrição |
---|---|
STATUS_BUFFER_TOO_SMALL | O buffer fornecido é de tamanho insuficiente. |
STATUS_UNSUCCESSFUL | A solicitação não pode ser atendida. |
STATUS_SUCCESS | O buffer foi preenchido corretamente. |
Comentários
Se o buffer for de comprimento insuficiente, nenhuma ID será gravada e ReturnLength (se fornecido) será preenchido com o tamanho do buffer necessário.
Atualmente, essa rotina só tem suporte em sistemas ARM64.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows 10, versão 1803 |
Cabeçalho | wdm.h (include Wdm.h) |