Función RtlCmEncodeMemIoResource (wdm.h)

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

Sintaxis

NTSYSAPI NTSTATUS RtlCmEncodeMemIoResource(
  [in] PCM_PARTIAL_RESOURCE_DESCRIPTOR Descriptor,
  [in] UCHAR                           Type,
  [in] ULONGLONG                       Length,
  [in] ULONGLONG                       Start
);

Parámetros

[in] Descriptor

Puntero a la estructura CM_PARTIAL_RESOURCE_DESCRIPTOR que se va a actualizar.

[in] Type

Tipo de recurso de la memoria. Este parámetro puede ser CmResourceTypeMemory, CmResourceTypeMemoryLarge o CmResourceTypePort.

[in] Length

Longitud, en bytes, del intervalo de direcciones asignadas.

[in] Start

Dirección inicial del intervalo de direcciones de puerto de E/S o memoria.

Valor devuelto

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

Código devuelto	Descripción
STATUS_SUCCESS	Se ha actualizado la estructura CM_PARTIAL_RESOURCE_DESCRIPTOR .
STATUS_UNSUCCESSFUL	El valor especificado para Length no se puede codificar en una estructura de CM_PARTIAL_RESOURCE_DESCRIPTOR .
STATUS_INVALID_PARAMETER	Uno o varios de los parámetros especificados no son válidos.

Comentarios

Las direcciones que tienen más de 32 bits de longitud deben cumplir ciertas restricciones de alineación o, de lo contrario, 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

CM_PARTIAL_RESOURCE_DESCRIPTOR

RtlCmDecodeMemIoResource