JetGetThreadStats fonction)
S’applique à : Windows | Windows Serveurs
JetGetThreadStats fonction)
La fonction JetGetThreadStats récupère les informations de performance du moteur de base de données pour le thread actuel. Plusieurs appels peuvent être utilisés pour collecter des statistiques qui reflètent l’activité du moteur de base de données sur ce thread entre ces appels.
**Windows vista :**JetGetThreadStats est introduit dans Windows vista.
JET_ERR JET_API JetGetThreadStats(
__out void* pvResult,
__in unsigned long cbMax
);
Paramètres
pvResult
Mémoire tampon de sortie qui reçoit les données de statistiques de thread. La mémoire tampon contient une structure JET_THREADSTATS après un appel réussi.
cbMax
Taille maximale, en octets, de la mémoire tampon de sortie.
Valeur renvoyée
Cette fonction retourne le type de données JET_ERR avec l’un des codes de retour suivants. pour plus d’informations sur les erreurs ESE possibles, consultez erreurs du moteur de Stockage Extensible et paramètres de gestion des erreurs.
Code de retour |
Description |
|---|---|
JET_errSuccess |
L’opération s’est terminée avec succès. |
JET_errBufferTooSmall |
L’opération a échoué, car la mémoire tampon de sortie fournie était trop petite pour contenir les données demandées. La fonction JetGetThreadStats renvoie cette erreur lorsque la mémoire tampon de sortie est trop petite pour contenir la version la plus petite de la structure JET_THREADSTATS prise en charge par le moteur de base de données. |
En cas de réussite, la mémoire tampon de sortie contient une structure JET_THREADSTATS qui contient les statistiques du moteur de base de données pour le thread actuel.
En cas d’échec, l’état de la mémoire tampon de sortie n’est pas défini.
Notes
Les informations fournies par deux appels consécutifs de cette API sont destinées à calculer le coût des autres opérations du moteur de base de données sur le thread actuel. En règle générale, cette opération s’effectue en acceptant une valeur avant et après la lecture des statistiques et en soustrayant le nombre d’opérations après le comptage avant d’obtenir le nombre net d’opérations effectuées.
Par exemple, une application peut appeler JetGetThreadStats une fois pour obtenir une lecture initiale des statistiques du thread actuel. Elle peut ensuite appeler la fonction JetMove avec le paramètre cRow défini sur JET_MoveNext pour passer à l’entrée d’index suivante sur un index. Il peut ensuite appeler JetGetThreadStats à nouveau pour recevoir une autre lecture des statistiques du thread. Il peut ensuite soustraire le compteur cPageReferenced de la deuxième lecture du premier. Le résultat est le nombre de pages de base de données référencées par le moteur de base de données pour effectuer l’opération JetMove .
Les statistiques de chaque thread sont accumulées pendant la durée de vie de ce thread. Les statistiques sont réinitialisées si la DLL du moteur de base de données est déchargée du processus hôte.
La structure JET_THREADSTATS sera probablement développée à l’avenir pour contenir plus de statistiques. De nouvelles statistiques seront ajoutées à la fin de la structure et peuvent être récupérées avec une taille de mémoire tampon de sortie accrue. La présence de statistiques supplémentaires peut être déduite par une valeur cbStruct plus grande.
Spécifications
| Condition requise | Valeur |
|---|---|
Client |
requiert Windows Vista. |
Serveur |
requiert Windows Server 2008. |
En-tête |
Déclaré dans esent. h. |
Bibliothèque |
Utilisez ESENT. lib. |
DLL |
Requiert ESENT.dll. |