Função RtlIoEncodeMemIoResource (wdm.h)

  • Artigo

A rotina RtlIoEncodeMemIoResource atualiza uma estrutura IO_RESOURCE_DESCRIPTOR para descrever um intervalo de memória ou endereços de porta de E/S.

Sintaxe

NTSYSAPI NTSTATUS RtlIoEncodeMemIoResource(
  [in] PIO_RESOURCE_DESCRIPTOR Descriptor,
  [in] UCHAR                   Type,
  [in] ULONGLONG               Length,
  [in] ULONGLONG               Alignment,
  [in] ULONGLONG               MinimumAddress,
  [in] ULONGLONG               MaximumAddress
);

Parâmetros

[in] Descriptor

Um ponteiro para a estrutura IO_RESOURCE_DESCRIPTOR a ser atualizada.

[in] Type

O tipo de recurso do intervalo de endereços. Esse parâmetro pode ser CmResourceTypeMemory, CmResourceTypeMemoryLarge ou CmResourceTypePort.

[in] Length

O comprimento, em bytes, do intervalo de endereços atribuíveis.

[in] Alignment

O alinhamento, em bytes, do endereço inicial do intervalo de endereços.

[in] MinimumAddress

O endereço mínimo que pode ser atribuído ao dispositivo.

[in] MaximumAddress

O endereço máximo que pode ser atribuído ao dispositivo.

Retornar valor

RtlIoEncodeMemIoResource retorna um valor NTSTATUS. Essa rotina pode retornar um dos seguintes valores:

Código de retorno Descrição
STATUS_SUCCESS
 A estrutura IO_RESOURCE_DESCRIPTOR foi atualizada.
STATUS_UNSUCCESSFUL
 O valor especificado para Length ou Alignment não pôde ser codificado em uma estrutura IO_RESOURCE_DESCRIPTOR .
STATUS_INVALID_PARAMETER
 Um ou mais dos parâmetros especificados eram inválidos.

Comentários

Endereços com mais de 32 bits de comprimento devem atender a determinadas restrições de alinhamento ou então a rotina retorna STATUS_UNSUCCESSFUL.

Comprimento do endereço Restrição de alinhamento
40 bits Os 8 bits mais baixos devem ser zero.
48 bits Os 16 bits mais baixos devem ser zero.
64 bits Os 32 bits mais baixos devem ser zero.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows Vista e versões posteriores do Windows.
Plataforma de Destino Universal
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL Qualquer nível

Confira também

IO_RESOURCE_DESCRIPTOR

RtlIoDecodeMemIoResource