Fonction QueryIoRateControlInformationJobObject (jobapi2.h)

Article
08/24/2023

Obtient des informations sur le contrôle du taux d’E/S d’un objet de travail.

Syntaxe

DWORD QueryIoRateControlInformationJobObject(
  [in, optional] HANDLE                                hJob,
  [in, optional] PCWSTR                                VolumeName,
  [out]          JOBOBJECT_IO_RATE_CONTROL_INFORMATION **InfoBlocks,
  [out]          ULONG                                 *InfoBlockCount
);

Paramètres

[in, optional] hJob

Handle du travail à interroger pour obtenir des informations. Obtenez ce handle à partir de la fonction CreateJobObject ou OpenJobObject . Le handle doit avoir le droit d’accès JOB_OBJECT_QUERY . Pour plus d’informations sur les droits d’accès, consultez Sécurité des objets de travail et droits d’accès.

Si cette valeur est NULL et que le processus qui appelle QueryIoRateControlInformationJobObject est associé à un travail, la fonction utilise le travail associé au processus. Si le travail est imbriqué dans un autre travail, la fonction utilise le travail immédiat pour le processus.

[in, optional] VolumeName

Nom du volume à interroger. Si cette valeur est NULL, la fonction obtient les informations sur le contrôle de débit d’E/S pour le travail pour tous les volumes du système.

[out] InfoBlocks

Pointeur vers un tableau de structures JOBOBJECT_IO_RATE_CONTROL_INFORMATION qui contiennent les informations sur le contrôle de débit d’E/S pour le travail. Votre code doit libérer la mémoire de ce tableau en appelant la fonction FreeMemoryJobObject avec l’adresse du tableau.

[out] InfoBlockCount

Nombre de structures JOBOBJECT_IO_RATE_CONTROL_INFORMATION allouées par la fonction dans le tableau vers lequel pointe le paramètre InfoBlocks .

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. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Notes

Important À compter de Windows 10 version 1607, cette fonction n’est plus prise en charge.

Configuration requise


Client minimal pris en charge	Windows 10 (applications de bureau uniquement)
Serveur minimal pris en charge	Windows Server 2016 (applications de bureau uniquement)
Plateforme cible	Windows
En-tête	jobapi2.h
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

FreeMemoryJobObject

JOBOBJECT_IO_RATE_CONTROL_INFORMATION

SetIoRateControlInformationJobObject

Partager via