Fungsi RtlCmEncodeMemIoResource (wdm.h)

  • Artikel

RtlCmEncodeMemIoResource rutin memperbarui struktur CM_PARTIAL_RESOURCE_DESCRIPTOR untuk menjelaskan berbagai alamat port memori atau I/O.

Sintaks

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

Parameter

[in] Descriptor

Penunjuk ke struktur CM_PARTIAL_RESOURCE_DESCRIPTOR untuk diperbarui.

[in] Type

Jenis sumber daya memori. Parameter ini dapat berupa CmResourceTypeMemory, CmResourceTypeMemoryLarge, atau CmResourceTypePort.

[in] Length

Panjangnya, dalam byte, dari rentang alamat yang dialokasikan.

[in] Start

Alamat awal rentang memori atau alamat port I/O.

Nilai kembali

RtlCmEncodeMemIoResource mengembalikan nilai NTSTATUS. Rutinitas ini mungkin mengembalikan salah satu nilai berikut:

Menampilkan kode Deskripsi
STATUS_SUCCESS
 Struktur CM_PARTIAL_RESOURCE_DESCRIPTOR telah diperbarui.
STATUS_UNSUCCESSFUL
 Nilai yang ditentukan untuk Panjang tidak dapat dikodekan dalam struktur CM_PARTIAL_RESOURCE_DESCRIPTOR .
STATUS_INVALID_PARAMETER
 Satu atau beberapa parameter yang ditentukan tidak valid.

Keterangan

Alamat yang panjangnya lebih dari 32 bit harus memenuhi batasan perataan tertentu atau jika tidak, rutin mengembalikan STATUS_UNSUCCESSFUL.

Panjang alamat Pembatasan perataan
40 bit 8 bit terendah harus nol.
48 bit 16 bit terendah harus nol.
64 bit 32 bit terendah harus nol.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia di Windows Vista dan versi Windows yang lebih baru.
Target Platform Universal
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL Tingkat apa pun

Lihat juga

CM_PARTIAL_RESOURCE_DESCRIPTOR

RtlCmDecodeMemIoResource