Compartilhar via


Função QueryIoRateControlInformationJobObject (jobapi2.h)

Obtém informações sobre o controle da taxa de E/S de um objeto de trabalho.

Sintaxe

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

Parâmetros

[in, optional] hJob

Um identificador para o trabalho a ser consultado para obter informações. Obtenha esse identificador da função CreateJobObject ou OpenJobObject . O identificador deve ter o acesso de JOB_OBJECT_QUERY correto. Para obter mais informações sobre direitos de acesso, consulte Segurança do objeto de trabalho e direitos de acesso.

Se esse valor for NULL e o processo que chama QueryIoRateControlInformationJobObject estiver associado a um trabalho, a função usará o trabalho associado ao processo. Se o trabalho estiver aninhado em outro trabalho, a função usará o trabalho imediato para o processo.

[in, optional] VolumeName

O nome do volume a ser consultado. Se esse valor for NULL, a função obterá as informações sobre o controle de taxa de E/S do trabalho para todos os volumes do sistema.

[out] InfoBlocks

Um ponteiro para a matriz de estruturas de JOBOBJECT_IO_RATE_CONTROL_INFORMATION que contêm as informações sobre o controle de taxa de E/S para o trabalho. Seu código deve liberar a memória dessa matriz chamando a função FreeMemoryJobObject com o endereço da matriz.

[out] InfoBlockCount

O número de JOBOBJECT_IO_RATE_CONTROL_INFORMATION estruturas que a função alocou na matriz à qual o parâmetro InfoBlocks aponta.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Importante A partir do Windows 10, versão 1607, essa função não tem mais suporte.
 

Requisitos

   
Cliente mínimo com suporte Windows 10 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2016 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho jobapi2.h
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

FreeMemoryJobObject

JOBOBJECT_IO_RATE_CONTROL_INFORMATION

SetIoRateControlInformationJobObject