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 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 miniport di visualizzazione deve indicare tutti i componenti di alimentazione per cui dovrà chiamare la funzione DXGKCB_COMPLETEFSTATETRANSITION impostando il DXGK_POWER_COMPONENT_FLAGS. Membro DriverCompletesFStateTransition su 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 della porta prevede che, quando questa funzione viene restituita, la transizione dello 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 in DISPATCH_LEVEL o deve attivare altri componenti di alimentazione. Questa funzione consente al driver miniport di visualizzare per completare la transizione dello 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.

Requisiti

   
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