QueryIoRateControlInformationJobObject, fonction (jobapi2.h)

Article
01/16/2025

Windows 10, version 1607 et ultérieure : cette fonction n’est pas prise en charge.

Obtient des informations sur le contrôle du taux d’E/S pour 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 vers le travail à interroger pour obtenir des informations. Obtenez ce handle à partir de la fonction CreateJobObject ou fonction OpenJobObject. Le handle doit disposer du droit d’accès JOB_OBJECT_QUERY. Pour plus d’informations sur les droits d’accès, consultez Job Object Security and Access Rights.

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 le 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 auquel les InfoBlocks points de paramètre.

Valeur de retour

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’erreur étendues, appelez GetLastError.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10 [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2016 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	jobapi2.h
bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

FreeMemoryJobObject

JOBOBJECT_IO_RATE_CONTROL_INFORMATION

SetIoRateControlInformationJobObject

Partager via