CmUnRegisterCallback-Funktion (wdm.h)
Die CmUnRegisterCallback-Routine hebt die Registrierung einer RegistryCallback-Routine auf, die zuvor von einer CmRegisterCallback - oder CmRegisterCallbackEx-Routine registriert wurde.
Syntax
NTSTATUS CmUnRegisterCallback(
[in] LARGE_INTEGER Cookie
);
Parameter
[in] Cookie
Ein LARGE_INTEGER Wert, der die Rückrufroutine zum Aufheben der Registrierung identifiziert. CmRegisterCallback hat diesen Wert bei der Registrierung der Rückrufroutine angegeben.
Rückgabewert
CmUnRegisterCallback gibt STATUS_SUCCESS zurück, wenn es erfolgreich ist, oder den entsprechenden NTSTATUS-Fehlercode , wenn er fehlschlägt. Wenn der Cookie-Parameter nicht mit registrierten Rückrufroutinen übereinstimmt, gibt CmUnRegisterCallback STATUS_INVALID_PARAMETER zurück.
Hinweise
Ein Treiber, der CmRegisterCallback oder CmRegisterCallbackEx aufruft , sollte CmUnRegisterCallback aufrufen, bevor der Treiber entladen wird.
Ein Treiber darf CmUnRegisterCallback nicht über seine Implementierung der RegistryCallback-Routine aufrufen. Dieser Aufruf führt zu einem Deadlock.
Weitere Informationen zu CmUnRegisterCallback und zum Filtern von Registrierungsvorgängen finden Sie unter Filtern von Registrierungsaufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| Header | wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
| DDI-Complianceregeln | HwStorPortProhibitedDIs(storport), IrqlExApcLte2(wdm) |