Función PsSetCreateThreadNotifyRoutine (ntddk.h)

Artículo
02/26/2024

La rutina PsSetCreateThreadNotifyRoutine registra una devolución de llamada proporcionada por el controlador que se notifica posteriormente cuando se crea un nuevo subproceso y cuando se elimina dicho subproceso.

Sintaxis

NTSTATUS PsSetCreateThreadNotifyRoutine(
  [in] PCREATE_THREAD_NOTIFY_ROUTINE NotifyRoutine
);

Parámetros

[in] NotifyRoutine

Puntero a la implementación del controlador de PCREATE_THREAD_NOTIFY_ROUTINE rutina.

Valor devuelto

PsSetCreateThreadNotifyRoutine devuelve STATUS_SUCCESS o devuelve STATUS_INSUFFICIENT_RESOURCES si se produjo un error en el registro de devolución de llamada.

Comentarios

Los controladores de nivel superior pueden llamar a PsSetCreateThreadNotifyRoutine para configurar sus rutinas de notificación de creación de subprocesos, declaradas de la siguiente manera:

VOID
(*PCREATE_THREAD_NOTIFY_ROUTINE) (
    IN HANDLE  ProcessId,
    IN HANDLE  ThreadId,
    IN BOOLEAN  Create
    );

Por ejemplo, un controlador de generación de perfiles del sistema de nivel superior o IFS puede registrar dicha devolución de llamada de creación de subprocesos para realizar un seguimiento de la creación y eliminación de subprocesos en todo el sistema en el estado interno del controlador.

Un controlador debe quitar las devoluciones de llamada que registre antes de descargarla. Puede quitar la devolución de llamada llamando a la rutina PsRemoveCreateThreadNotifyRoutine .

Requisitos

Requisito	Value
Plataforma de destino	Universal
Encabezado	ntddk.h (incluya Ntddk.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Reglas de cumplimiento de DDI	HwStorPortProhibitedDIs(storport), IrqlPsPassive(wdm), PowerIrpDDis(wdm)