Método IDXGIDevice::SetGPUThreadPriority (dxgi.h)

Define a prioridade do thread de GPU.

Sintaxe

HRESULT SetGPUThreadPriority(
  INT Priority
);

Parâmetros

Priority

Tipo: INT

Um valor que especifica a prioridade de thread de GPU necessária. Consulte a seção Comentários neste tópico.

Valor de retorno

Tipo: HRESULT

Retornar S_OK se tiver êxito; caso contrário, retornará E_INVALIDARG se o parâmetro Priority for inválido.

Observações

Para usar o método SetGPUThreadPriority , você deve ter uma compreensão abrangente do agendamento de GPU. Se usado de forma inadequada, o método SetGPUThreadPriority pode impedir a velocidade de renderização e resultar em uma experiência ruim do usuário, portanto, crie o perfil do aplicativo para entender o impacto da alteração de prioridade no aplicativo e no sistema.

Os valores para a função de parâmetro Priority da seguinte maneira: Definição de bits de valores prioritários:

Bit 0-4: Valor de prioridade
Bit 5-29: Reservado
Bit 30: Sinalizador de Prioridade Absoluta ( D3DKMT_SETCONTEXTSCHEDULINGPRIORITY_ABSOLUTE), pode ser ORed com Bits de Valor de Prioridade [4:0] (válido somente para Windows 10+, caso contrário, não usado)
Bit 31: bit assinado

O Bit 30 (Sinalizador de Prioridade Absoluta) pode ser usado para controlar o modo de operação dessa API.

Modo de Prioridade Relativa : a API usará esse modo quando o valor do bit 30 for definido como 0. Nesse modo, o valor de prioridade deve estar entre -7 e 7, inclusive, onde o valor de prioridade 0 representa prioridade normal (Padrão para todos os contextos) e -7 representa prioridade ociosa. O bit 31 é usado para controlar o sinal da prioridade.

Modo de Prioridade Absoluta : a API usará esse modo quando o valor do bit 30 for definido como 1. Nesse modo, o valor de prioridade (para bits[4:0]) deve estar entre 0 e 31. O significado desses níveis de prioridade é descrito abaixo. Use D3DKMT_SETCONTEXTSCHEDULINGPRIORITY_ABSOLUTE somente se você tiver uma compreensão completa das prioridades de dxgkrnl/gráficos e entender as repercussões de alterá-las.

Os Bits de Valores de Prioridade[4:0] se traduzem nos seguintes valores de prioridade:

0: Prioridade ociosa – o progresso para frente não será garantido se as prioridades mais altas usarem a maior parte do tempo do acelerador.
1: Prioridade Normal – a maioria dos processos usa essa prioridade com garantia de progresso.
2 -15: Reservado -
16-29 : Soft Realtime - Preempts lower priorities and periodically yields to lower priorities to ensure their forward progress.
30 : Hard Realtime – usado para cargas de trabalho altamente limitadas sensíveis à latência. Essa prioridade não gera prioridades mais baixas.
31: Uso interno

Requisitos

Consulte também

interfaces DXGI

IDXGIDevice

IDXGIDevice::GetGPUThreadPriority