GetLogIoStatistics, fonction (clfsw32.h)

  • Article

Récupère les statistiques d’E/S du journal pour un journal dédié ou multiplexé associé au handle spécifié. Cette fonction interroge common log file system (CLFS) des types spécifiques de statistiques d’E/S du journal. L’appel de cette fonction sur un journal multiplexé associe uniquement les statistiques au journal sous-jacent.

Syntaxe

CLFSUSER_API BOOL GetLogIoStatistics(
  [in]            HANDLE             hLog,
  [in, out]       PVOID              pvStatsBuffer,
  [in]            ULONG              cbStatsBuffer,
  [in]            CLFS_IOSTATS_CLASS eStatsClass,
  [out, optional] PULONG             pcbStatsWritten
);

Paramètres

[in] hLog

Handle pour un fichier journal ouvert que CreateLogFile obtient. Le handle de journal peut faire référence à un fichier journal dédié ou multiplexé.

[in, out] pvStatsBuffer

Pointeur vers une mémoire tampon pour recevoir les statistiques d’E/S.

Cette mémoire tampon doit être au moins aussi volumineuse qu’un en-tête de paquet de statistiques d’E/S. Pour plus d’informations, consultez CLFS_IO_STATISTICS_HEADER.

[in] cbStatsBuffer

Taille de la mémoire tampon de statistiques d’E/S pvStatsBuffer, en octets.

Si la mémoire tampon n’est pas suffisamment grande pour le paquet de statistiques, la fonction échoue avec ERROR_MORE_DATA.

[in] eStatsClass

Ce paramètre n’est pas implémenté pour l’instant ; il est réservé pour une utilisation ultérieure.

[out, optional] pcbStatsWritten

Pointeur vers une variable pour recevoir la taille du paquet de statistiques d’E/S écrit dans pvStatsBuffer.

Cette valeur est inférieure ou égale à cbStatsBuffer.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro (0). Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError. La liste suivante identifie les codes d’erreur possibles :

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête clfsw32.h
Bibliothèque Clfsw32.lib
DLL Clfsw32.dll

Voir aussi

CLFS_IOSTATS_CLASS

CLFS_IO_STATISTICS_HEADER

Fonctions courantes du système de fichiers journaux