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

DXGKCB_COMPLETEFSTATETRANSITION notifica o driver de porta de que um componente de energia concluiu a transição de estado F.

Sintaxe

DXGKCB_COMPLETEFSTATETRANSITION DxgkcbCompletefstatetransition;

void DxgkcbCompletefstatetransition(
  [in] IN_CONST_HANDLE hAdapter,
  [in] UINT ComponentIndex
)
{...}

Parâmetros

[in] hAdapter

Um identificador para o adaptador de exibição. O driver de miniporto de exibição recebe o identificador do membro DeviceHandle da estrutura DXGKRNL_INTERFACE em uma chamada para sua função DxgkDdiStartDevice .

[in] ComponentIndex

O índice do componente de energia especificado por DXGKARG_QUERYADAPTERINFO. pInputData em uma chamada para a função DxgkDdiQueryAdapterInfo .

Retornar valor

Nenhum

Comentários

Durante o registro do componente, o driver de miniporto de exibição deve indicar todos os componentes de energia para os quais ele precisará chamar a função DXGKCB_COMPLETEFSTATETRANSITION definindo o DXGK_POWER_COMPONENT_FLAGS. DriverCompletesFStateTransition membro para 1. Quando esse membro é definido, o driver deve chamar essa função de forma síncrona ou assíncrona. Por outro lado, se esse membro não estiver definido, o driver não deverá chamar essa função.

A estrutura de gerenciamento de energia do Windows garante que nenhuma nova solicitação de transição será enviada para o componente até que essa função seja chamada.

Normalmente, o driver de porta espera que, quando essa função retornar, a transição de estado F seja concluída. Pode haver cenários em que o driver de miniporto de exibição não possa concluir a transição de forma síncrona, por exemplo, se o driver de miniporto de exibição não puder concluir as transições em DISPATCH_LEVEL ou precisar ativar outros componentes de energia. Essa função ajuda o driver de miniporto de exibição a concluir a transição de estado F de forma assíncrona.

DXGKCB_XXX funções são implementadas por Dxgkrnl. Para usar essa função de retorno de chamada, defina os membros do DXGKARGCB_ALLOCATEPAGESFORMDL e chame DxgkCbCompleteFStateTransition por meio do DXGKRNL_INTERFACE.

Requisitos

Confira também

DXGK_POWER_COMPONENT_FLAGS

DXGKRNL_INTERFACE