POB_PRE_OPERATION_CALLBACK Rückruffunktion (wdm.h)
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"). |