Funzione QueryIoRateControlInformationJobObject (jobapi2.h)

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 da eseguire una query per informazioni. Ottenere questo handle dalla funzione CreateJobObject o OpenJobObject . L'handle deve avere il diritto di accesso JOB_OBJECT_QUERY . Per altre informazioni sui diritti di accesso, vedere Sicurezza oggetti processo e diritti di accesso.

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

[in, optional] VolumeName

Nome del volume da 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 che la funzione allocata nella matrice a cui punta il parametro InfoBlocks .

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 informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Requisiti

Vedere anche

FreeMemoryJobObject

JOBOBJECT_IO_RATE_CONTROL_INFORMATION

SetIoRateControlInformationJobObject