Condividi tramite


Funzione CmRegisterCallback (wdm.h)

La routine CmRegisterCallback è obsoleta per Windows Vista e versioni successive del sistema operativo. Usare cmRegisterCallbackEx .

La routine CmRegisterCallback registra una routine RegistryCallback .

Sintassi

NTSTATUS CmRegisterCallback(
  [in]           PEX_CALLBACK_FUNCTION Function,
  [in, optional] PVOID                 Context,
  [out]          PLARGE_INTEGER        Cookie
);

Parametri

[in] Function

Puntatore alla routine RegistryCallback da registrare.

[in, optional] Context

Valore definito dal driver che configuration manager passerà come parametro CallbackContext alla routine RegistryCallback

[out] Cookie

Puntatore a una variabile LARGE_INTEGER che riceve il valore che identifica la routine di callback. Quando si annulla la registrazione della routine di callback, passare questo valore come parametro Cookie a CmUnRegisterCallback.

Valore restituito

CmRegisterCallback restituisce STATUS_SUCCESS se l'operazione ha esito positivo o il codice di errore NTSTATUS appropriato in caso di errore.

Commenti

La routine CmRegisterCallback è disponibile in Windows XP e versioni successive del sistema operativo. Per Windows Vista e versioni successive del sistema operativo, è invece consigliabile usare CmRegisterCallbackEx .

Un driver chiama CmRegisterCallback per registrare una routine RegistryCallback , che viene chiamata ogni volta che un thread esegue un'operazione nel Registro di sistema.

Chiamare CmUnRegisterCallback per annullare la registrazione di una routine di callback registrata da CmRegisterCallback .

Per altre informazioni sulle operazioni di CmRegisterCallback e filtro del Registro di sistema, vedere Filtro delle chiamate al Registro di sistema.

Requisiti

Requisito Valore
Client minimo supportato Disponibile in Windows XP e versioni successive di Windows.
Piattaforma di destinazione Universale
Intestazione wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <=APC_LEVEL
Regole di conformità DDI HwStorPortProhibitedDDDIs(storport), IrqlExApcLte2(wdm)

Vedi anche

CmRegisterCallbackEx

CmUnRegisterCallback

RegistryCallback