Função PsSetLoadImageNotifyRoutine (ntddk.h)
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.
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
PsRemoveLoadImageNotifyRoutine