Funzione RtlCmEncodeMemIoResource (wdm.h)

Articolo
02/29/2024

La routine RtlCmEncodeMemIoResource aggiorna una struttura CM_PARTIAL_RESOURCE_DESCRIPTOR per descrivere un intervallo di indirizzi di porta di memoria o I/O.

Sintassi

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

Parametri

[in] Descriptor

Puntatore alla struttura CM_PARTIAL_RESOURCE_DESCRIPTOR da aggiornare.

[in] Type

Tipo di risorsa della memoria. Questo parametro può essere CmResourceTypeMemory, CmResourceTypeMemoryLarge o CmResourceTypePort.

[in] Length

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

[in] Start

Indirizzo iniziale dell'intervallo di indirizzi di memoria o di porte di I/O.

Valore restituito

RtlCmEncodeMemIoResource restituisce un valore NTSTATUS. Questa routine può restituire uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	La struttura CM_PARTIAL_RESOURCE_DESCRIPTOR è stata aggiornata.
STATUS_UNSUCCESSFUL	Il valore specificato per Length non può essere codificato in una struttura CM_PARTIAL_RESOURCE_DESCRIPTOR .
STATUS_INVALID_PARAMETER	Uno o più parametri specificati non sono validi.

Commenti

Gli indirizzi di lunghezza maggiore di 32 bit devono soddisfare determinate restrizioni di allineamento oppure la routine restituisce STATUS_UNSUCCESSFUL.

Lunghezza indirizzo	Restrizione dell'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

CM_PARTIAL_RESOURCE_DESCRIPTOR

RtlCmDecodeMemIoResource

Condividi tramite