Funzione NtQueryInformationResourceManager (wdm.h)

Articolo
07.02.2025

La routine ZwQueryInformationResourceManager recupera informazioni su un oggetto di resource manager specificato.

Sintassi

C++

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

Parametri

[in] ResourceManagerHandle

Handle per un oggetto resource manager ottenuto da una chiamata precedente a ZwCreateResourceManager o ZwOpenResourceManager. L'handle deve avere RESOURCEMANAGER_QUERY_INFORMATION accesso all'oggetto.

[in] ResourceManagerInformationClass

Valore RESOURCEMANAGER_INFORMATION_CLASStipizzato che specifica le informazioni da recuperare. Questo valore deve essere ResourceManagerBasicInformation.

[out] ResourceManagerInformation

Puntatore a una struttura di RESOURCEMANAGER_BASIC_INFORMATION allocata dal chiamante che riceve informazioni da ZwQueryInformationResourceManager.

[in] ResourceManagerInformationLength

Lunghezza, in byte, del buffer a cui punta il parametro ResourceManagerInformation.

[out, optional] ReturnLength

Puntatore a una variabile allocata dal chiamante che riceve la lunghezza, in byte, delle informazioni che KTM scrive nel buffer ResourceManagerInformation. Questo parametro è facoltativo e può essere NULL.

Valore restituito

ZwQueryInformationResourceManager restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questa routine potrebbe restituire uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_OBJECT_TYPE_MISMATCH	L'handle specificato non è un handle per un oggetto resource manager.
STATUS_INVALID_HANDLE	Un handle di oggetto non è valido.
STATUS_INVALID_INFO_CLASS	Il valore del parametro ResourceManagerInformationClass non è valido.
STATUS_BUFFER_TOO_SMALL	Le dimensioni del buffer specificate dal parametro ResourceManagerInformationLength sono inferiori alla struttura RESOURCEMANAGER_BASIC_INFORMATION.
STATUS_BUFFER_OVERFLOW	Le dimensioni del buffer specificate dal parametro ResourceManagerInformationLength sono troppo piccole per ricevere tutte le informazioni a lunghezza variabile disponibili.
STATUS_ACCESS_DENIED	Il chiamante non dispone dell'accesso appropriato all'oggetto resource manager.

La routine potrebbe restituire altri valori NTSTATUS .

Osservazioni

Per altre informazioni sulla routine ZwQueryInformationResourceManager, vedere Creating a Resource Manager.

NtQueryInformationResourceManager e ZwQueryInformationResourceManager sono due versioni della stessa routine di Servizi di sistema nativi di Windows.

Per le chiamate da driver in modalità kernel, le NtXxx e ZwXxx versioni di una routine di Windows Native System Services possono comportarsi in modo diverso nel modo in cui gestiscono e interpretano i parametri di input. Per altre informazioni sulla relazione tra le versioni NtXxx e ZwXxx di una routine, vedere Using Nt and Zw Versions of the Native System Services Routines.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile in Windows Vista e versioni successive del sistema operativo.
piattaforma di destinazione	Universale
intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
libreria	NtosKrnl.lib
dll	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
regole di conformità DDI	HwStorPortProhibitedDDIs, PowerIrpDDis