Fungsi NtQueryInformationResourceManager (wdm.h)

Artikel
03/08/2023

Rutinitas ZwQueryInformationResourceManager mengambil informasi tentang objek resource manager tertentu.

Sintaks

__kernel_entry NTSYSCALLAPI NTSTATUS NtQueryInformationResourceManager(
  [in]            HANDLE                            ResourceManagerHandle,
  [in]            RESOURCEMANAGER_INFORMATION_CLASS ResourceManagerInformationClass,
  [out]           PVOID                             ResourceManagerInformation,
  [in]            ULONG                             ResourceManagerInformationLength,
  [out, optional] PULONG                            ReturnLength
);

Parameter

[in] ResourceManagerHandle

Handel ke objek resource manager yang diperoleh oleh panggilan sebelumnya ke ZwCreateResourceManager atau ZwOpenResourceManager. Handel harus memiliki akses RESOURCEMANAGER_QUERY_INFORMATION ke objek .

[in] ResourceManagerInformationClass

Nilai berjenis RESOURCEMANAGER_INFORMATION_CLASS yang menentukan informasi yang akan diambil. Nilai ini harus ResourceManagerBasicInformation.

[out] ResourceManagerInformation

Penunjuk ke struktur RESOURCEMANAGER_BASIC_INFORMATION yang dialokasikan pemanggil yang menerima informasi dari ZwQueryInformationResourceManager.

[in] ResourceManagerInformationLength

Panjangnya, dalam byte, dari buffer yang dirujuk oleh parameter ResourceManagerInformation .

[out, optional] ReturnLength

Penunjuk ke variabel yang dialokasikan pemanggil yang menerima panjang, dalam byte, dari informasi yang ditulis KTM ke buffer ResourceManagerInformation . Parameter ini bersifat opsional dan dapat berupa NULL.

Nilai kembali

ZwQueryInformationResourceManager mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, rutinitas ini mungkin mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
STATUS_OBJECT_TYPE_MISMATCH	Handel yang ditentukan bukan handel ke objek resource manager.
STATUS_INVALID_HANDLE	Handel objek tidak valid.
STATUS_INVALID_INFO_CLASS	Nilai parameter ResourceManagerInformationClass tidak valid.
STATUS_BUFFER_TOO_SMALL	Ukuran buffer yang ditentukan parameter ResourceManagerInformationLength lebih kecil dari struktur RESOURCEMANAGER_BASIC_INFORMATION.
STATUS_BUFFER_OVERFLOW	Ukuran buffer yang ditentukan parameter ResourceManagerInformationLength terlalu kecil untuk menerima semua informasi panjang variabel yang tersedia.
STATUS_ACCESS_DENIED	Pemanggil tidak memiliki akses yang sesuai ke objek manajer sumber daya.

Rutinitas mungkin mengembalikan nilai NTSTATUS lainnya.

Keterangan

Untuk informasi selengkapnya tentang rutinitas ZwQueryInformationResourceManager, lihat Membuat Resource Manager.

NtQueryInformationResourceManager dan ZwQueryInformationResourceManager adalah dua versi dari rutinitas Layanan Sistem Asli Windows yang sama.

Untuk panggilan dari driver mode kernel, versi NtXxx dan ZwXxx dari rutinItas Windows Native System Services dapat berperilaku berbeda dalam cara mereka menangani dan menginterpretasikan parameter input. Untuk informasi selengkapnya tentang hubungan antara versi NtXxx dan ZwXxx dari rutinitas, lihat Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows Vista dan versi sistem operasi yang lebih baru.
Target Platform	Universal
Header	wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Aturan kepatuhan DDI	HwStorPortProhibitedDDIs, PowerIrpDDis