Função PsSetLoadImageNotifyRoutine (ntddk.h)

  • Artigo

A rotina PsSetLoadImageNotifyRoutine registra um retorno de chamada fornecido pelo driver que é notificado posteriormente sempre que uma imagem (por exemplo, uma DLL ou EXE) é carregada (ou mapeada na memória).

Sintaxe

NTSTATUS PsSetLoadImageNotifyRoutine(
  [in] PLOAD_IMAGE_NOTIFY_ROUTINE NotifyRoutine
);

Parâmetros

[in] NotifyRoutine

Um ponteiro para o chamador implementado PLOAD_IMAGE_NOTIFY_ROUTINE rotina de retorno de chamada para notificações de imagem de carga.

Retornar valor

PsSetLoadImageNotifyRoutine retorna STATUS_SUCCESS ou retorna STATUS_INSUFFICIENT_RESOURCES se falhou no registro de retorno de chamada.

Comentários

Os drivers de criação de perfil de sistema de nível mais alto podem chamar PsSetLoadImageNotifyRoutine para configurar suas rotinas de notificação de imagem de carga (consulte PLOAD_IMAGE_NOTIFY_ROUTINE).

O número máximo de drivers que podem ser registrados simultaneamente para receber notificações de imagem de carga é de oito. Se o número máximo de rotinas de notificação de imagem de carga já estiver registrado quando um driver chamar PsSetLoadImageNotifyRoutine para tentar registrar uma rotina de notificação adicional, PsSetLoadImageNotifyRoutine falhará e retornará STATUS_INSUFFICIENT_RESOURCES.

Observações

  • Uma atualização para Windows 8.1 aumenta o número máximo de drivers registrados para receber notificações de imagem de carga de oito para 64. Essa atualização é instalada como parte de uma atualização cumulativa que está disponível por meio de Windows Update a partir de 8 de abril de 2014. Além disso, essa atualização cumulativa está disponível em https://support.microsoft.com/kb/2919355.
  • Os usuários do Windows 7 com Service Pack 1 (SP1) podem instalar um hotfix para aumentar o número máximo de drivers registrados para receber notificações de imagem de carga de 8 para 64. Esse hotfix está disponível em https://support.microsoft.com/kb/2922790.
Um driver deve remover quaisquer retornos de chamada registrados antes de descarregar. Você pode remover o retorno de chamada chamando a rotina PsRemoveLoadImageNotifyRoutine .

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível a partir do Windows 2000.
Plataforma de Destino Universal
Cabeçalho ntddk.h (inclua Ntddk.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Regras de conformidade da DDI HwStorPortProhibitedDIs(storport), IrqlPsPassive(wdm), PowerIrpDDis(wdm)

Confira também

PLOAD_IMAGE_NOTIFY_ROUTINE

PsGetCurrentProcessId

PsRemoveLoadImageNotifyRoutine

PsSetCreateProcessNotifyRoutine

PsSetCreateThreadNotifyRoutine