DXGKCB_COMPLETEFSTATETRANSITION funzione di callback (d3dkmddi.h)
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 |