WdfDeviceInitSetPowerPageable 函式 (wdfdevice.h)

[僅適用於 KMDF]

WdfDeviceInitSetPowerPageable 方法會通知電源管理員，當系統在睡眠狀態與工作 (S0) 狀態之間轉換時，驅動程式必須能夠存取可分頁數據。

語法

void WdfDeviceInitSetPowerPageable(
  [in] PWDFDEVICE_INIT DeviceInit
);

參數

[in] DeviceInit

呼叫端提供的 WDFDEVICE_INIT 結構的指標。

傳回值

無

備註

如果您的函式驅動程式或總線驅動程式呼叫 WdfDeviceInitSetPowerPageable，系統可確保當驅動程式的裝置 進入低電源狀態 或 回到其工作狀態時，分頁檔案的裝置處於其運作 (D0) 狀態。 這可讓您的驅動程式在裝置的電源轉換期間存取檔案、登錄和分頁集區。

根據預設，架構可讓您存取函式驅動程式的可分頁數據。 架構會針對總線驅動程式列舉的每個子裝置使用父裝置的設定，除非總線驅動程式呼叫子裝置 的 WdfDeviceInitSetPowerPageable 或 WdfDeviceInitSetPowerNotPageable 。 如果您撰寫的總線驅動程式會呼叫子裝置的 WdfDeviceInitSetPowerPageable ，則子裝置堆疊中沒有任何驅動程式可以呼叫 WdfDeviceInitSetPowerNotPageable。

從篩選驅動程式呼叫 WdfDeviceInitSetPowerPageable 或 WdfDeviceInitSetPowerNotPageable 沒有任何作用。 架構會使用下一個較低驅動程式指定的設定。

大部分驅動程式不需要呼叫 WdfDeviceInitSetPowerPageable 或 WdfDeviceInitSetPowerNotPageable。 相反地，您應該讓架構使用適用於驅動程式的預設設定。 不過，如果驅動程式是驅動程式在電源轉換期間不得存取可分頁數據的驅動程式堆疊，則驅動程式應該呼叫 WdfDeviceInitSetPowerNotPageable (，例如儲存堆疊或視訊堆疊) ，或驅動程式是列舉可能是儲存裝置或視訊裝置的總線驅動程式。

如果您的驅動程式呼叫 WdfDeviceInitSetPowerInrush，它不得呼叫 WdfDeviceInitSetPowerPageable。

您的驅動程序必須先呼叫 WdfDeviceInitSetPowerPageable ，才能呼叫 WdfDeviceCreate。

如需呼叫 WdfDeviceCreate 的詳細資訊，請參閱 建立架構裝置物件。

範例

下列程式代碼範例會通知電源管理員，當系統在睡眠狀態與工作 (S0) 狀態之間轉換時，驅動程式必須能夠存取可分頁的數據。

WdfDeviceInitSetPowerPageable(DeviceInit);

規格需求

需求	值
目標平台	Universal
最低 KMDF 版本	1.0
標頭	wdfdevice.h (包含 Wdf.h)
程式庫	Wdf01000.sys (請參閱 Framework Library Versioning.)
IRQL	<= DISPATCH_LEVEL
DDI 合規性規則	ChildDeviceInitAPI (kmdf) 、 DeviceInitAPI (kmdf) 、 DriverCreate (kmdf ) 、 KmdfIrql (kmdf ) 、 KmdfIrql2 (kmdf) 、KmdfIrqlExplicit (kmdf) 、 PdoDeviceInitAPI (kmdf)

另請參閱

WdfDeviceInitSetPowerNotPageable