POB_PRE_OPERATION_CALLBACK Rückruffunktion (wdm.h)

  • Artikel

Die ObjectPreCallback-Routine wird vom Betriebssystem aufgerufen, wenn ein Prozess- oder Threadhandlevorgang auftritt.

Warnung

Die Aktionen, die Sie in diesem Rückruf ausführen können, sind für sichere Anrufe eingeschränkt. Weitere Informationen finden Sie unter Windows Kernel-Mode Prozess- und Thread-Manager.

Syntax

POB_PRE_OPERATION_CALLBACK PobPreOperationCallback;

OB_PREOP_CALLBACK_STATUS PobPreOperationCallback(
  [in] PVOID RegistrationContext,
  [in] POB_PRE_OPERATION_INFORMATION OperationInformation
)
{...}

Parameter

[in] RegistrationContext

Der Kontext, den der Treiber als CallBackRegistration-RegistrationContext-Parameter der ObRegisterCallbacks-Routine> angibt. Die Bedeutung dieses Werts ist treiberdefiniert.

[in] OperationInformation

Ein Zeiger auf eine OB_PRE_OPERATION_INFORMATION-Struktur , die die Parameter des Handlevorgangs angibt.

Rückgabewert

ObjectPreCallback gibt einen OB_PREOP_CALLBACK_STATUS Wert zurück. Treiber müssen OB_PREOP_SUCCESS zurückgeben.

Hinweise

Verwenden Sie die ObRegisterCallbacks-Routine , um eine ObjectPreCallback-Routine zu registrieren, und verwenden Sie die ObUnRegisterCallbacks-Routine , um die Registrierung der Routine aufzuheben.

Diese Routine wird bei PASSIVE_LEVEL in einem beliebigen Threadkontext mit deaktivierten normalen Kernel-APCs aufgerufen. Spezielle Kernel-APCs sind nicht deaktiviert. Weitere Informationen zu APCs finden Sie unter Typen von APCs.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar ab Windows Server 2008.
Zielplattform Desktop
Header wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
IRQL Wird unter PASSIVE_LEVEL aufgerufen (siehe Abschnitt "Hinweise").

Weitere Informationen

OB_PRE_OPERATION_INFORMATION

ObRegisterCallbacks

ObUnRegisterCallbacks

ObjectPostCallback