Freigeben über


PCREATE_PROCESS_NOTIFY_ROUTINE_EX Rückruffunktion (ntddk.h)

Eine rückrufroutine, die von einem Treiber implementiert wird, um den Aufrufer zu benachrichtigen, wenn ein Prozess erstellt oder beendet wird.

Warnung

Die Aktionen, die Sie in dieser Routine ausführen können, sind für sichere Anrufe eingeschränkt. Siehe best Practices.

Syntax

PCREATE_PROCESS_NOTIFY_ROUTINE_EX PcreateProcessNotifyRoutineEx;

void PcreateProcessNotifyRoutineEx(
  [_Inout_]           PEPROCESS Process,
  [in]                HANDLE ProcessId,
  [in, out, optional] PPS_CREATE_NOTIFY_INFO CreateInfo
)
{...}

Parameter

[_Inout_] Process

Ein Zeiger auf die EPROCESS-Struktur, die den Prozess darstellt. Treiber können die PsGetCurrentProcess und ObReferenceObjectByHandle Routinen verwenden, um einen Zeiger auf die EPROCESS-Struktur für einen Prozess abzurufen.

[in] ProcessId

Die Prozess-ID des Prozesses.

[in, out, optional] CreateInfo

Ein Zeiger auf eine PS_CREATE_NOTIFY_INFO Struktur, die Informationen zum neuen Prozess enthält. Wenn dieser Parameter NULL ist, wird der angegebene Prozess beendet.

Rückgabewert

Nichts

Bemerkungen

Treiber der höchsten Ebene rufen PsSetCreateProcessNotifyRoutineEx- auf, um ihre Implementierung der PCREATE_PROCESS_NOTIFY_ROUTINE_EX Routine zu registrieren. Ein installierbares Dateisystem (IFS) oder ein Systemprofiltreiber auf höchster Ebene registriert möglicherweise eine Rückrufroutine zur Prozesserstellung, um nachzuverfolgen, welche Prozesse erstellt und für den internen Zustand des Treibers im gesamten System gelöscht werden.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Ab Windows 2000 verfügbar.
Zielplattform- Universal
Header- ntddk.h (include Ntddk.h)
IRQL- PASSIVE_LEVEL

Siehe auch

PsSetCreateProcessNotifyRoutineEx

PsSetCreateProcessNotifyRoutineEx2