Função NtQueryInformationResourceManager (wdm.h)

Artigo
02/07/2025

A rotina de ZwQueryInformationResourceManager recupera informações sobre um objeto do gerenciador de recursos especificado.

Sintaxe

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

Parâmetros

[in] ResourceManagerHandle

Um identificador para um objeto do gerenciador de recursos obtido por uma chamada anterior para ZwCreateResourceManager ou ZwOpenResourceManager. O identificador deve ter acesso RESOURCEMANAGER_QUERY_INFORMATION ao objeto.

[in] ResourceManagerInformationClass

Um valor RESOURCEMANAGER_INFORMATION_CLASSdigitado que especifica as informações a serem recuperadas. Esse valor deve ser ResourceManagerBasicInformation.

[out] ResourceManagerInformation

Um ponteiro para uma estrutura de RESOURCEMANAGER_BASIC_INFORMATION alocada por chamador que recebe informações de ZwQueryInformationResourceManager .

[in] ResourceManagerInformationLength

O comprimento, em bytes, do buffer para o qual o parâmetro ResourceManagerInformation aponta.

[out, optional] ReturnLength

Um ponteiro para uma variável alocada por chamador que recebe o comprimento, em bytes, das informações que o KTM grava no buffer ResourceManagerInformation. Esse parâmetro é opcional e pode ser NULL.

Valor de retorno

ZwQueryInformationResourceManager retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, essa rotina poderá retornar um dos seguintes valores:

Código de retorno	Descrição
STATUS_OBJECT_TYPE_MISMATCH	O identificador especificado não é um identificador para um objeto do gerenciador de recursos.
STATUS_INVALID_HANDLE	Um identificador de objeto é inválido.
STATUS_INVALID_INFO_CLASS	O valor do parâmetro ResourceManagerInformationClass é inválido.
STATUS_BUFFER_TOO_SMALL	O tamanho do buffer especificado pelo parâmetro ResourceManagerInformationLength é menor que a estrutura RESOURCEMANAGER_BASIC_INFORMATION.
STATUS_BUFFER_OVERFLOW	O tamanho do buffer especificado pelo parâmetro ResourceManagerInformationLength é muito pequeno para receber todas as informações de comprimento variável disponíveis.
STATUS_ACCESS_DENIED	O chamador não tem acesso apropriado ao objeto do gerenciador de recursos.

A rotina pode retornar outros valores NTSTATUS .

Observações

Para obter mais informações sobre a rotina de ZwQueryInformationResourceManager, consulte Criando umdo Resource Manager.

NtQueryInformationResourceManager e ZwQueryInformationResourceManager são duas versões da mesma rotina dos Serviços de Sistema Nativo do Windows.

Para chamadas de drivers no modo kernel, as versões NtXxx e Zwxxx versões de uma rotina dos Serviços de Sistema Nativo do Windows podem se comportar de forma diferente na maneira como lidam e interpretam parâmetros de entrada. Para obter mais informações sobre a relação entre as versões NtXxx e ZwXxx de uma rotina, consulte Usando versões Nt e Zw das rotinas de serviços do sistema nativo.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Windows Vista e versões posteriores do sistema operacional.
da Plataforma de Destino	Universal
cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
regras de conformidade de DDI	HwStorPortProhibitedDIs, PowerIrpDDis

Consulte também

RESOURCEMANAGER_BASIC_INFORMATION

RESOURCEMANAGER_INFORMATION_CLASS

usando versões Nt e Zw das rotinas de serviços do sistema nativo

ZwCreateResourceManager

ZwOpenResourceManager

ZwRecoverResourceManager

ZwSetInformationResourceManager

Compartilhar via