DXGKCB_SETPOWERCOMPONENTRESIDENCY回呼函式 （d3dkmddi.h）
核心模式顯示迷你埠驅動程式會呼叫 DXGKCB_SETPOWERCOMPONENTRESIDENCY，以設定類型為 DXGK_POWER_COMPONENT_OTHER電源元件的預期落地。
語法
DXGKCB_SETPOWERCOMPONENTRESIDENCY DxgkcbSetpowercomponentresidency;
void DxgkcbSetpowercomponentresidency(
[in] IN_CONST_HANDLE hAdapter,
[in] UINT ComponentIndex,
[in] ULONGLONG Residency
)
{...}
參數
[in] hAdapter
顯示配接器的句柄。 顯示迷你埠驅動程式會從呼叫其 DxgkDdiStartDevice 函式的 DXGKRNL_INTERFACE 結構 DeviceHandle 成員接收句柄。
[in] ComponentIndex
DXGKARG_QUERYADAPTERINFO所指定的電源元件索引。在呼叫 DxgkDdiQueryAdapterInfo 函式時，pInputData。
[in] Residency
預期的落地 -- 最大時間，單位為 100 奈秒 - 顯示迷你埠驅動程式預期電源元件在進入閑置狀態后保持閑置。 Power Management Framework 會使用這項資訊，為未違反要求落地的元件選取適當的閑置狀態。 落地 所指定的預期落地仍有效，直到驅動程式再次呼叫此函式來更新它為止。 請參閱。
傳回值
沒有
言論
注意
只有當元件類型 DXGK_POWER_COMPONENT_OTHER時，顯示迷你埠驅動程式才應該呼叫此函式。 DirectX 圖形核心子系統會設定其他元件類型的預期落地值。
DXGKCB_XXX 函式是由 Dxgkrnl實作。 若要使用此回呼函式，請透過 DXGKRNL_INTERFACE呼叫 DxgkCbSetPowerComponentResidency。
如果呼叫此函式時電源元件處於閑置狀態，Power Management Framework 可能會變更元件的 F 狀態，以符合 Residency所指定的預期落地值。
如果驅動程式將 Residency 設定為 PO_FX_UNKNOWN_TIME 的值（定義於 Wdm.h中），Power Engine 外掛程式 （PEP） 可能無法將元件設定為低於 F0 的 F 狀態。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 8 （WDDM 1.2） |
| 支援的最低伺服器 | Windows Server 2012 |
| 目標平臺 | 桌面 |
| 標頭 | d3dkmddi.h （包括 D3dkmddi.h） |
| IRQL | <= DISPATCH_LEVEL |