QueryIoRateControlInformationJobObject-Funktion (jobapi2.h)

Windows 10, Version 1607 und höher: Diese Funktion wird nicht unterstützt.

Ruft Informationen zum Steuern der E/A-Rate für ein Auftragsobjekt ab.

Syntax

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

Parameter

[in, optional] hJob

Ein Handle für den Auftrag, der nach Informationen abgefragt werden soll. Rufen Sie dieses Handle aus der CreateJobObject-- oder OpenJobObject--Funktion ab. Das Handle muss über das JOB_OBJECT_QUERY Zugriffsrecht verfügen. Weitere Informationen zu Zugriffsrechten finden Sie unter Job Object Security and Access Rights.

Wenn dieser Wert NULL ist und der Prozess, der QueryIoRateControlInformationJobObject aufruft, einem Auftrag zugeordnet ist, verwendet die Funktion den Auftrag, der dem Prozess zugeordnet ist. Wenn der Auftrag in einem anderen Auftrag geschachtelt ist, verwendet die Funktion den unmittelbaren Auftrag für den Prozess.

[in, optional] VolumeName

Der Name des abzufragenden Volumes. Wenn dieser Wert NULL ist, ruft die Funktion die Informationen über die E/A-Rate-Steuerung für den Auftrag für alle Volumes für das System ab.

[out] InfoBlocks

Ein Zeiger auf ein Array von JOBOBJECT_IO_RATE_CONTROL_INFORMATION Strukturen, die die Informationen zum E/A-Rate-Steuerelement für den Auftrag enthalten. Ihr Code muss den Speicher für dieses Array freigeben, indem das FreeMemoryJobObject Funktion mit der Adresse des Arrays aufgerufen wird.

[out] InfoBlockCount

Die Anzahl der JOBOBJECT_IO_RATE_CONTROL_INFORMATION Strukturen, die die Funktion im Array zugeordnet hat, auf die die InfoBlocks Parameterpunkte verweist.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Anforderungen

Siehe auch

FreeMemoryJobObject

JOBOBJECT_IO_RATE_CONTROL_INFORMATION

SetIoRateControlInformationJobObject