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 DeviceHandle membro da estrutura DXGKRNL_INTERFACE em uma chamada para sua função DxgkDdiStartDevice.
[in] ComponentIndex
O índice de componente de energia especificado por DXGKARG_QUERYADAPTERINFO.pInputData em uma chamada para a função DxgkDdiQueryAdapterInfo.
Valor de retorno
Nenhum
Observações
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.
Nota
Se DXGK_POWER_COMPONENT_FLAGS.DriverCompletesFStateTransition foi definido, mas o driver não chama essa função, podem ocorrer deadlocks.
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 pode 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_LEVELou 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
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 8 (WDDM 1.2) |
| servidor com suporte mínimo | Windows Server 2012 |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | d3dkmddi.h (inclua D3dkmddi.h) |
| IRQL | <=DISPATCH_LEVEL |