Compartilhar via


Função QueryIoRateControlInformationJobObject (jobapi2.h)

Windows 10, versão 1607 e mais recente: não há suporte para essa função.

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 para consultar informações. Obtenha esse identificador da função CreateJobObject ou OpenJobObject. O identificador deve ter o acesso 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 estruturas JOBOBJECT_IO_RATE_CONTROL_INFORMATION que a função alocou na matriz à qual o InfoBlocks pontos de parâmetro.

Valor de retorno

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

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

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 10 [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2016 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho jobapi2.h
biblioteca Kernel32.lib
de DLL Kernel32.dll

Consulte também

FreeMemoryJobObject

JOBOBJECT_IO_RATE_CONTROL_INFORMATION

SetIoRateControlInformationJobObject