Compartir a través de

Función RtlIoEncodeMemIoResource (wdm.h)

  • Artículo

La rutina RtlIoEncodeMemIoResource actualiza una estructura de IO_RESOURCE_DESCRIPTOR para describir un intervalo de direcciones de puerto de E/S o memoria.

Sintaxis

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

Puntero a la estructura IO_RESOURCE_DESCRIPTOR que se va a actualizar.

[in] Type

Tipo de recurso del intervalo de direcciones. Este parámetro puede ser CmResourceTypeMemory, CmResourceTypeMemoryLarge o CmResourceTypePort.

[in] Length

Longitud, en bytes, del intervalo de direcciones asignables.

[in] Alignment

Alineación, en bytes, de la dirección inicial del intervalo de direcciones.

[in] MinimumAddress

La dirección mínima que se puede asignar al dispositivo.

[in] MaximumAddress

Dirección máxima que se puede asignar al dispositivo.

Valor devuelto

RtlIoEncodeMemIoResource devuelve un valor NTSTATUS. Esta rutina puede devolver uno de los siguientes valores:

Código devuelto Descripción
STATUS_SUCCESS
 Se actualizó la estructura IO_RESOURCE_DESCRIPTOR .
STATUS_UNSUCCESSFUL
 El valor especificado para Length o Alignment no se pudo codificar en una estructura de IO_RESOURCE_DESCRIPTOR .
STATUS_INVALID_PARAMETER
 Uno o varios de los parámetros especificados no eran válidos.

Comentarios

Las direcciones que tienen más de 32 bits de longitud deben satisfacer ciertas restricciones de alineación, o bien la rutina devuelve STATUS_UNSUCCESSFUL.

Longitud de la dirección Restricción de alineación
40 bits Los 8 bits más bajos deben ser cero.
48 bits Los 16 bits más bajos deben ser cero.
64 bits Los 32 bits más bajos deben ser cero.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows Vista y versiones posteriores de Windows.
Plataforma de destino Universal
Encabezado wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL Cualquier nivel

Consulte también

IO_RESOURCE_DESCRIPTOR

RtlIoDecodeMemIoResource