Fonction CmRegisterCallback (wdm.h)

  • Article

La routine CmRegisterCallback est obsolète pour Windows Vista et les versions ultérieures du système d’exploitation. Utilisez CmRegisterCallbackEx à la place.

La routine CmRegisterCallback inscrit une routine RegistryCallback .

Syntaxe

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

Paramètres

[in] Function

Pointeur vers la routine RegistryCallback à inscrire.

[in, optional] Context

Valeur définie par le pilote que le gestionnaire de configuration passera en tant que paramètre CallbackContext à la routine RegistryCallback

[out] Cookie

Pointeur vers une variable LARGE_INTEGER qui reçoit la valeur qui identifie la routine de rappel. Lorsque vous annulez l’inscription de la routine de rappel, passez cette valeur en tant que paramètre Cookie à CmUnRegisterCallback.

Valeur retournée

CmRegisterCallback retourne STATUS_SUCCESS si l’opération réussit ou le code d’erreur NTSTATUS approprié en cas d’échec.

Remarques

La routine CmRegisterCallback est disponible sur Windows XP et les versions ultérieures du système d’exploitation. Pour Windows Vista et les versions ultérieures du système d’exploitation, vous devez utiliser CmRegisterCallbackEx à la place.

Un pilote appelle CmRegisterCallback pour inscrire une routine RegistryCallback , qui est appelée chaque fois qu’un thread effectue une opération sur le Registre.

Appelez CmUnRegisterCallback pour annuler l’inscription d’une routine de rappel inscrite par CmRegisterCallback .

Pour plus d’informations sur CmRegisterCallback et le filtrage des opérations de Registre, consultez Filtrage des appels du Registre.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows XP et les versions ultérieures de Windows.
Plateforme cible Universal
En-tête wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <=APC_LEVEL
Règles de conformité DDI HwStorPortProhibitedDDIs(storport),IrqlExApcLte2(wdm)

Voir aussi

CmRegisterCallbackEx

CmUnRegisterCallback

RegistryCallback