DXGKCB_SETPOWERCOMPONENTRESIDENCY funzione di callback (d3dkmddi.h)

Un driver miniport in modalità kernel chiama DXGKCB_SETPOWERCOMPONENTRESIDENCY per impostare la residenza prevista per un componente di alimentazione di tipo DXGK_POWER_COMPONENT_OTHER.

Sintassi

DXGKCB_SETPOWERCOMPONENTRESIDENCY DxgkcbSetpowercomponentresidency;

void DxgkcbSetpowercomponentresidency(
  [in] IN_CONST_HANDLE hAdapter,
  [in] UINT ComponentIndex,
  [in] ULONGLONG Residency
)
{...}

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 .

[in] Residency

La residenza prevista, ovvero il tempo massimo, in unità di 100 nanosecondi, che il driver miniport dello schermo prevede che un componente di alimentazione rimanga inattivo dopo che entra in uno stato di inattività. Power Management Framework usa queste informazioni per selezionare uno stato di inattività appropriato per il componente che non viola la residenza richiesta. La residenza prevista specificata dalla residenza rimane attiva fino a quando il driver chiama nuovamente questa funzione per aggiornarla. Vedere la sezione Osservazioni.

Valore restituito

nessuno

Osservazioni

DXGKCB_XXX funzioni vengono implementate da Dxgkrnl. Per usare questa funzione di callback, chiamare DxgkCbSetPowerComponentResidency tramite il DXGKRNL_INTERFACE.

Se il componente di alimentazione si trova in uno stato di inattività quando questa funzione viene chiamata, Power Management Framework potrebbe modificare lo stato F del componente in modo da soddisfare il valore di residenza previsto specificato dalla residenza.

Se il driver imposta La residenza su un valore di PO_FX_UNKNOWN_TIME (definito in Wdm.h), il plug-in del motore di alimentazione (PEP) potrebbe non essere in grado di impostare il componente su uno stato F inferiore a F0.

Requisiti

Vedi anche

DXGKARG_QUERYADAPTERINFO

DXGKRNL_INTERFACE

DxgkDdiQueryAdapterInfo

DxgkDdiStartDevice