KeDeregisterBugCheckCallback

BOOLEAN
KeDeregisterBugCheckCallback(

IN PKBUGCHECK_CALLBACK_RECORD CallbackRecord
);

KeDeregisterBugCheckCallback removes a device driver’s callback routine from the set of registered bug-check callbacks.

Parameters

CallbackRecord

Points to the caller-allocated storage containing an initialized bug-check callback record. This pointer was previously passed in successful calls to KeInitializeCallbackRecord and KeRegisterBugCheckCallback.

Return Value

KeDeregisterBugCheckCallback returns TRUE if the caller-supplied bug-check callback routine will no longer be called if a bug check occurs. If the given callback record was not registered, it returns FALSE.

Comments

KeDeregisterBugCheckCallback is the reciprocal of KeRegisterBugCheckCallback.

If an unloadable device driver sets up a bug-check callback routine with KeRegisterBugCheckCallback, that driver’s Unload routine must call KeDeregisterBugCheckCallback before it frees the storage it allocated at CallbackRecord.

Callers of KeDeregisterBugCheckRecord can be running at any IRQL. Usually, a device driver is running at IRQL PASSIVE_LEVEL in its Unload routine when it calls KeDeregisterBugCheckRecord.

See Also

KeBugCheck, KeBugCheckEx, KeInitializeCallbackRecord, KeRegisterBugCheckCallback