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) |