Compteurs de navigation

Pour afficher une boîte de dialogue qui répertorie les objets de performance et les compteurs définis sur l’ordinateur, appelez la fonction PdhBrowseCounters . La boîte de dialogue permet à l’utilisateur de parcourir et de sélectionner des compteurs de performances. Vous utilisez la structure PDH_BROWSE_DLG_CONFIG pour spécifier la configuration de la boîte de dialogue. Par exemple, vous pouvez configurer la boîte de dialogue pour retourner une ou plusieurs sélections.

Lors de l’entrée, le membre szReturnPathBuffer contient l’objet et le compteur de performances par défaut sélectionnés dans la boîte de dialogue. Lors de la sortie, la mémoire tampon contient l’objet de performance et le compteur sélectionnés par l’utilisateur. Vous pouvez également utiliser le membre pCallBack pour spécifier une fonction de rappel afin de traiter les noms de compteurs retournés par la boîte de dialogue.

Notez que cette boîte de dialogue peut renvoyer PDH_DIALOG_CANCELLED si bSingleCounterPerDialog a la valeur FALSE et que l’utilisateur clique sur le bouton Fermer, de sorte que votre gestion des erreurs doit tenir compte de cela.

Pour obtenir un exemple qui utilise la fonction PdhBrowseCounters , consultez Compteurs de performances de navigation.

Pour récupérer une liste d’objets de performances sur l’ordinateur, vous pouvez également appeler la fonction PdhEnumObjects . Pour récupérer une liste de compteurs et d’instances pour un objet de performance, appelez la fonction PdhEnumObjectItems . Vous pouvez également utiliser ces fonctions pour identifier les objets de performance et les compteurs contenus dans un fichier journal. Les appels répétés à PdhEnumObjectItems retournent la même liste de compteurs et d’instances jusqu’à ce que vous appeliez PdhEnumObjects pour actualiser d’abord la liste des objets de performance. Pour obtenir un exemple qui énumère des objets et des compteurs, consultez Énumération d’objets de processus.

Sélection de la source de données

Vous pouvez utiliser PdhSelectDataSource conjointement avec PdhBrowseCounters pour inviter l’utilisateur à choisir si la source de données est en temps réel ou à partir d’un fichier journal, et, s’il s’agit d’un fichier journal, son nom. Si vous ne souhaitez pas afficher la boîte de dialogue de source de données, vous pouvez appeler PdhSelectDataSource pour afficher uniquement le catalogue de l’explorateur de fichiers. Pour ce faire, spécifiez PDH_FLAGS_FILE_BROWSER_ONLY comme deuxième paramètre de l’appel à PdhSelectDataSource.