DXGKCB_COMPLETEFSTATETRANSITION funzione di callback (d3dkmddi.h)

  • Articolo

DXGKCB_COMPLETEFSTATETRANSITION notifica al driver di porta che un componente di alimentazione ha completato la transizione dello stato F.

Sintassi

DXGKCB_COMPLETEFSTATETRANSITION DxgkcbCompletefstatetransition;

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

Parametri

[in] hAdapter

Handle per l'adattatore di visualizzazione. Il driver miniport visualizzato riceve l'handle dal membro DeviceHandle della struttura DXGKRNL_INTERFACE in una chiamata alla funzione DxgkDdiStartDevice .

[in] ComponentIndex

Indice del componente di alimentazione specificato da DXGKARG_QUERYADAPTERINFO. pInputData in una chiamata alla funzione DxgkDdiQueryAdapterInfo .

Valore restituito

nessuno

Osservazioni

Durante la registrazione del componente il driver miniport visualizzato deve indicare tutti i componenti di alimentazione per i quali sarà necessario chiamare la funzione DXGKCB_COMPLETEFSTATETRANSITION impostando ilDXGK_POWER_COMPONENT_FLAGS. DriverCompletesFStateTransition membro a 1. Quando questo membro è impostato, il driver deve chiamare questa funzione in modo sincrono o asincrono. Al contrario, se questo membro non è impostato, il driver non deve chiamare questa funzione.

Nota

Se DXGK_POWER_COMPONENT_FLAGS. DriverCompletesFStateTransition è stato impostato, ma il driver non chiama questa funzione, i deadlock potrebbero verificarsi.

Il framework di gestione energia di Windows garantisce che non venga inviata alcuna nuova richiesta di transizione per il componente finché non viene chiamata questa funzione.

In genere, il driver di porta prevede che quando questa funzione restituisce, la transizione dello stato F viene completata. Potrebbero esserci scenari quando il driver miniport visualizzato non può completare la transizione in modo sincrono, ad esempio se il driver miniport visualizzato non può completare le transizioni in DISPATCH_LEVEL o deve attivare altri componenti di alimentazione. Questa funzione consente al driver miniport di visualizzare per completare in modo asincrono la transizione con stato F.

DXGKCB_XXX funzioni vengono implementate da Dxgkrnl. Per usare questa funzione di callback, impostare i membri di DXGKARGCB_ALLOCATEPAGESFORMDL e quindi chiamare DxgkCbCompleteFStateTransition tramite il DXGKRNL_INTERFACE.

Requisiti

Requisito Valore
Client minimo supportato Windows 8 (WDDM 1.2)
Server minimo supportato Windows Server 2012
Piattaforma di destinazione Desktop
Intestazione d3dkmddi.h (include D3dkmddi.h)
IRQL <=DISPATCH_LEVEL

Vedi anche

DXGK_POWER_COMPONENT_FLAGS

DXGKRNL_INTERFACE