Funzione RtlIoEncodeMemIoResource (wdm.h)

Articolo
03/05/2024

La routine RtlIoEncodeMemIoResource aggiorna una struttura IO_RESOURCE_DESCRIPTOR per descrivere un intervallo di indirizzi di memoria o di I/O.

Sintassi

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

Parametri

[in] Descriptor

Puntatore alla struttura IO_RESOURCE_DESCRIPTOR da aggiornare.

[in] Type

Tipo di risorsa dell'intervallo di indirizzi. Questo parametro può essere CmResourceTypeMemory, CmResourceTypeMemoryLarge oCmResourceTypePort.

[in] Length

Lunghezza, in byte, dell'intervallo di indirizzi assegnabili.

[in] Alignment

Allineamento, in byte, dell'indirizzo iniziale dell'intervallo di indirizzi.

[in] MinimumAddress

Indirizzo minimo che può essere assegnato al dispositivo.

[in] MaximumAddress

Indirizzo massimo che può essere assegnato al dispositivo.

Valore restituito

RtlIoEncodeMemIoResource restituisce un valore NTSTATUS. Questa routine potrebbe restituire uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	La struttura IO_RESOURCE_DESCRIPTOR è stata aggiornata.
STATUS_UNSUCCESSFUL	Impossibile codificare il valore specificato per Length o Alignment in una struttura IO_RESOURCE_DESCRIPTOR .
STATUS_INVALID_PARAMETER	Uno o più dei parametri specificati non sono validi.

Commenti

Gli indirizzi con dimensioni maggiori di 32 bit in lunghezza devono soddisfare determinate restrizioni di allineamento oppure la routine restituisce STATUS_UNSUCCESSFUL.

Lunghezza indirizzo	Restrizione di allineamento
40 bit	I 8 bit più bassi devono essere zero.
48 bit	I 16 bit più bassi devono essere zero.
64 bit	I 32 bit più bassi devono essere zero.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive di Windows.
Piattaforma di destinazione	Universale
Intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	Qualsiasi livello

Vedi anche

IO_RESOURCE_DESCRIPTOR

RtlIoDecodeMemIoResource

Condividi tramite