RtlCmEncodeMemIoResource-Funktion (wdm.h)

  • Artikel

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