RtlIoEncodeMemIoResource-Funktion (wdm.h)

Artikel
02/27/2024

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

Syntax

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

Parameter

[in] Descriptor

Ein Zeiger auf die zu aktualisierende IO_RESOURCE_DESCRIPTOR-Struktur.

[in] Type

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

[in] Length

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

[in] Alignment

Die Ausrichtung der Anfangsadresse des Adressbereichs in Bytes.

[in] MinimumAddress

Die Mindestadresse, die dem Gerät zugewiesen werden kann.

[in] MaximumAddress

Die maximale Adresse, die dem Gerät zugewiesen werden kann.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die IO_RESOURCE_DESCRIPTOR-Struktur wurde aktualisiert.
STATUS_UNSUCCESSFUL	Der angegebene Wert für Length oder Alignment konnte nicht in einer IO_RESOURCE_DESCRIPTOR-Struktur codiert werden.
STATUS_INVALID_PARAMETER	Mindestens einer der angegebenen Parameter war 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 null sein.
48 Bits	Die niedrigsten 16 Bits müssen 0 (null) sein.
64 Bit	Die niedrigsten 32 Bits müssen null 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

IO_RESOURCE_DESCRIPTOR

RtlIoDecodeMemIoResource

Freigeben über