Compartilhar via


DXGKDDI_SETCONTEXTSCHEDULINGPROPERTIES função de retorno de chamada (d3dkmddi.h)

Configure ou modifique as propriedades de agendamento para um contexto de dispositivo.

Sintaxe

DXGKDDI_SETCONTEXTSCHEDULINGPROPERTIES DxgkddiSetcontextschedulingproperties;

NTSTATUS DxgkddiSetcontextschedulingproperties(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_SETCONTEXTSCHEDULINGPROPERTIES pSetContextSchedulingProperties
)
{...}

Parâmetros

hAdapter

Um identificador para o contexto do dispositivo.

pSetContextSchedulingProperties

Ponteiro para uma estrutura DXGKARG_SETCONTEXTSCHEDULINGPROPERTIES que contém as propriedades de agendamento.

Retornar valor

Retornar STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, retorne um código de erro NTSTATUS Values apropriado.

Comentários

Registre sua implementação dessa função de retorno de chamada definindo o membro apropriado de DXGKARG_SETCONTEXTSCHEDULINGPROPERTIES e, em seguida, chamando DxgkDdiSetContextSchedulingProperties.

Quando um adaptador é aberto pela primeira vez para um processo específico, o sistema operacional chama DxgkDdiCreateProcess para que o KMD (driver de modo kernel) possa criar uma estrutura de dados apropriada por processo, por adaptador. Quando um contexto é criado, o KMD sabe para qual dispositivo e adaptador ele é criado e deve ser capaz de pesquisar o identificador de processo KMD da estrutura de dados de acompanhamento do adaptador para esse processo. Dentro do processo KMD, espera-se que o agendador tenha estruturas de dados de rastreamento para todos os quatro contextos de faixas de prioridade potenciais aos quais devem ser atribuídos.

Quando um contexto é criado ou um dispositivo Direct3D altera a prioridade ou um aplicativo ganha ou perde o foco, o sistema operacional chama o agendador de GPU para configurar ou modificar suas propriedades de agendamento. Para contextos recém-criados, o sistema operacional garante que as propriedades de agendamento de contexto serão definidas antes do primeiro envio para esse contexto ser permitido. Essa chamada pode ser feita no meio de uma execução de contexto. O agendador de GPU tem alguma margem de manobra em termos de como ele afeta o período de agendamento atual, e o requisito do sistema operacional é que a alteração entre em vigor na próxima iteração de agendamento para a faixa de prioridade.

Requisitos

Requisito Valor
Cabeçalho d3dkmddi.h