RtlCmEncodeMemIoResource-Funktion (wdm.h)

Artikel
02/27/2024

Die RtlCmEncodeMemIoResource-Routine aktualisiert eine CM_PARTIAL_RESOURCE_DESCRIPTOR Struktur, um einen Bereich von Speicher- oder E/A-Portadressen zu beschreiben.

Syntax

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

Parameter

[in] Descriptor

Ein Zeiger auf die zu aktualisierende CM_PARTIAL_RESOURCE_DESCRIPTOR Struktur.

[in] Type

Der Ressourcentyp des Arbeitsspeichers. Dieser Parameter kann CmResourceTypeMemory, CmResourceTypeMemoryLarge oder CmResourceTypePort sein.

[in] Length

Die Länge des Bereichs der zugeordneten Adressen in Bytes.

[in] Start

Die Startadresse des Bereichs von Speicher- oder E/A-Portadressen.

Rückgabewert

RtlCmEncodeMemIoResource gibt einen NTSTATUS-Wert zurück. Diese Routine gibt möglicherweise einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die CM_PARTIAL_RESOURCE_DESCRIPTOR-Struktur wurde aktualisiert.
STATUS_UNSUCCESSFUL	Der angegebene Wert für Length kann nicht in einer CM_PARTIAL_RESOURCE_DESCRIPTOR-Struktur codiert werden.
STATUS_INVALID_PARAMETER	Mindestens ein parameter ist ungültig.

Hinweise

Adressen, die größer als 32 Bit sind, müssen bestimmte Ausrichtungseinschränkungen erfüllen, andernfalls gibt die Routine STATUS_UNSUCCESSFUL zurück.

Adresslänge	Ausrichtungseinschränkung
40 Bits	Die niedrigsten 8 Bits müssen 0 sein.
48 Bits	Die niedrigsten 16 Bits müssen 0 sein.
64 Bit	Die niedrigsten 32 Bits müssen 0 sein.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und späteren Windows-Versionen.
Zielplattform	Universell
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	Beliebige Ebene

Weitere Informationen

CM_PARTIAL_RESOURCE_DESCRIPTOR

RtlCmDecodeMemIoResource

Freigeben über