IOMMU_QUERY_INPUT_MAPPINGS função de retorno de chamada (wdm.h)

  • Artigo

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)