Funzione QueryIoRateControlInformationJobObject (jobapi2.h)

Articolo
01/16/2025

Windows 10 versione 1607 e successive: questa funzione non è supportata.

Ottiene informazioni sul controllo della frequenza di I/O per un oggetto processo.

Sintassi

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

Parametri

[in, optional] hJob

Handle per il processo su cui eseguire una query per ottenere informazioni. Ottenere questo handle dalla funzione di CreateJobObject o OpenJobObject. L'handle deve avere il diritto di accesso JOB_OBJECT_QUERY. Per altre informazioni sui diritti di accesso, vedere Job Object Security and Access Rights.

Se questo valore è NULL e il processo che chiama QueryIoRateControlInformationJobObject è associato a un processo, la funzione usa il processo associato al processo. Se il processo è annidato all'interno di un altro processo, la funzione usa il processo immediato per il processo.

[in, optional] VolumeName

Nome del volume su cui eseguire una query. Se questo valore è NULL, la funzione ottiene le informazioni sul controllo della frequenza di I/O per il processo per tutti i volumi per il sistema.

[out] InfoBlocks

Puntatore alla matrice di strutture JOBOBJECT_IO_RATE_CONTROL_INFORMATION che contengono le informazioni sul controllo della frequenza di I/O per il processo. Il codice deve liberare la memoria per questa matrice chiamando la funzione FreeMemoryJobObject con l'indirizzo della matrice.

[out] InfoBlockCount

Numero di strutture JOBOBJECT_IO_RATE_CONTROL_INFORMATION allocate dalla funzione nella matrice a cui punta il InfoBlocks parametro.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni estese sull'errore, chiamare GetLastError.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 10 [solo app desktop]
server minimo supportato	Windows Server 2016 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	jobapi2.h
libreria	Kernel32.lib
dll	Kernel32.dll

Vedere anche

FreeMemoryJobObject

JOBOBJECT_IO_RATE_CONTROL_INFORMATION

SetIoRateControlInformationJobObject

Condividi tramite