PcwUnregister, fonction (wdm.h)

  • Article

La PcwUnregister fonction ferme l’inscription de jeu de compteurs spécifié. La plupart des développeurs utiliseront une fonction UnregisterXxx générée par CTRPP au lieu d’appeler cette fonction directement.

Syntaxe

void PcwUnregister(
  PPCW_REGISTRATION Registration
);

Paramètres

Registration

[dans Pointeur vers l’inscription en cours de fermeture.

Valeur de retour

None

Remarques

La PcwUnregister fonction ferme l’inscription de jeu de compteurs spécifié. Les instances appartenant à l’inscription du compteur sont automatiquement fermées. Ces instances ne doivent pas être accessibles par le fournisseur tant que le compteur est en cours d’annulation ou après l’annulation de l’inscription du compteur.

Avant que le fournisseur utilise cette fonction, il doit appeler la fonction PcwRegister pour créer une inscription.

Fonction UnregisterXxx générée par CTRPP

La plupart des développeurs n’ont pas besoin d’appeler PcwUnregister directement. Au lieu de cela, ils compilent un manifeste avec l’outil CTRPP et utilisent la fonction UnregisterXxx à partir de l’en-tête généré par CTRPP. La fonction générée se présente comme suit :

EXTERN_C FORCEINLINE VOID
UnregisterMyCounterset(
    VOID
    )
{
    PAGED_CODE();

    PcwUnregister(MyCounterset);
}

La fonction Unregister générée par CTRPP sera nommée PrefixUnregisterCounterSet. Le préfixe est généralement vide, mais peut être présent si le -prefix paramètre a été utilisé sur la ligne de commande CTRPP. CounterSet est le nom du compteur, tel que spécifié dans le manifeste. Notez que la fonction fait référence à une variable Counterset (MyCounterset dans l’exemple), qui est une variable globale qui contient le handle d’inscription de jeu de compteurs initialisé par la fonction RegisterXxx générée par CTRPP.

Configuration requise

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

Voir aussi

PcwRegister, fonction