PcwCloseInstance, fonction (wdm.h)

La PcwCloseInstance fonction ferme un jeu de compteurs instance qui a été créé à l’aide de PcwCreateInstance. La plupart des développeurs utilisent une fonction CloseXxx générée par CTRPP au lieu d’appeler cette fonction directement.

Syntaxe

void PcwCloseInstance(
  [in] PPCW_INSTANCE Instance
);

Paramètres

[in] Instance

Pointeur vers le instance de contre-ensemble à fermer.

Valeur de retour

None

Remarques

Utilisez la PcwCreateInstance fonction pour créer un instance de compteurs.

Vous ne pouvez pas appeler PcwCloseInstance sur un instance si vous avez déjà appelé PcwUnregister pour l’inscription de jeu de compteurs correspondant. Lorsque vous annulez l’inscription du compteur, toutes les instances restantes sont fermées pour vous. Si vous les fermez à nouveau, le système se bloque.

Fonction CloseXxx générée par CTRPP

La plupart des développeurs n’ont pas besoin d’appeler PcwCloseInstance directement. Au lieu de cela, ils compilent un manifeste avec l’outil CTRPP et utilisent la fonction CloseXxx à 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
CloseMyCounterset(
    __in PPCW_INSTANCE Instance
    )
{
    PAGED_CODE();

    PcwCloseInstance(Instance);
}

La fonction Close générée par CTRPP sera nommée PrefixCloseCounterSet. 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.

Configuration requise

Voir aussi

PcwCreateInstance, fonction