Função ZwUnmapViewOfSection (wdm.h)

  • Artigo

A rotina ZwUnmapViewOfSection cancela uma exibição de uma seção do espaço de endereço virtual de um processo de assunto.

Sintaxe

NTSYSAPI NTSTATUS ZwUnmapViewOfSection(
  [in]           HANDLE ProcessHandle,
  [in, optional] PVOID  BaseAddress
);

Parâmetros

[in] ProcessHandle

Manipule para um objeto de processo que foi passado anteriormente para ZwMapViewOfSection.

[in, optional] BaseAddress

Ponteiro para o endereço virtual base do modo de exibição para cancelar o mapa. Esse valor pode ser qualquer endereço virtual dentro do modo de exibição.

Retornar valor

ZwUnmapViewOfSection retorna um valor NTSTATUS. Os possíveis valores retornados incluem:

Código de retorno Descrição
STATUS_SUCCESS A rotina realizou com êxito a operação solicitada.
STATUS_ACCESS_DENIED O chamador não tem direitos de acesso ao objeto de processo ou ao endereço virtual base do modo de exibição.

Comentários

Essa rotina cancela toda a exibição da seção que contém BaseAddress do espaço de endereço virtual do processo especificado, mesmo que BaseAddress não aponte para o início da exibição.

No retorno de ZwUnmapViewOfSection, a região de endereço virtual ocupada pelo modo de exibição não é mais reservada e está disponível para mapear outras exibições ou páginas privadas. Se a exibição também for a última referência à seção subjacente, todas as páginas confirmadas na seção serão descompactadas e a seção será excluída.

Se a chamada para essa função ocorrer no modo de usuário, você deverá usar o nome "NtUnmapViewOfSection" em vez de "ZwUnmapViewOfSection".

Para chamadas de drivers no modo kernel, as versões NtXxx e ZwXxx de uma rotina dos Serviços do 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 dos Serviços de Sistema Nativo.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Regras de conformidade de DDI HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Confira também

Usando versões Nt e Zw das rotinas dos Serviços de Sistema Nativo

ZwMapViewOfSection

ZwOpenSection