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)

Weitere Informationen

CmRegisterCallback

CmRegisterCallbackEx

RegistryCallback