DXGKCB_COMPLETEFSTATETRANSITION funzione di callback (d3dkmddi.h)
DXGKCB_COMPLETEFSTATETRANSITION notifica al driver di porta che un componente di alimentazione ha completato la transizione di stato F.
Sintassi
DXGKCB_COMPLETEFSTATETRANSITION DxgkcbCompletefstatetransition;
void DxgkcbCompletefstatetransition(
[in] IN_CONST_HANDLE hAdapter,
[in] UINT ComponentIndex
)
{...}
Parametri
[in] hAdapter
Handle per la scheda di visualizzazione. Il driver del miniport di visualizzazione riceve l'handle dal membro DeviceHandle della struttura DXGKRNL_INTERFACE in una chiamata alla relativa 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 del miniport di visualizzazione deve indicare tutti i componenti di alimentazione per i quali dovrà chiamare la funzione DXGKCB_COMPLETEFSTATETRANSITION impostando il DXGK_POWER_COMPONENT_FLAGS.DriverCompletesFStateTransition membro a 1. Quando questo membro è impostato, il driver deve chiamare questa funzione in modo sincrono o asincrono. Viceversa, 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, potrebbero verificarsi deadlock.
Il framework di risparmio energia di Windows garantisce che non venga inviata alcuna nuova richiesta di transizione per il componente fino a quando non viene chiamata questa funzione.
In genere, il driver di porta prevede che quando questa funzione viene restituita, la transizione di stato F viene completata. Potrebbero esserci scenari in cui il driver miniport di visualizzazione non può completare la transizione in modo sincrono, ad esempio se il driver miniport di visualizzazione non può completare le transizioni a DISPATCH_LEVELo deve attivare altri componenti di alimentazione. Questa funzione consente al driver miniport di visualizzare per completare la transizione di stato F in modo asincrono.
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.
Fabbisogno
| 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 |