Função NtQueryInformationResourceManager (wdm.h)
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 |
---|---|
|
O identificador especificado não é um identificador para um objeto do gerenciador de recursos. |
|
Um identificador de objeto é inválido. |
|
O valor do parâmetro ResourceManagerInformationClass é inválido. |
|
O tamanho do buffer especificado pelo parâmetro ResourceManagerInformationLength é menor que a estrutura RESOURCEMANAGER_BASIC_INFORMATION. |
|
O tamanho do buffer especificado pelo parâmetro ResourceManagerInformationLength é muito pequeno para receber todas as informações de comprimento variável disponíveis. |
|
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