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