WdfDeviceInitSetPowerNotPageable 函式 (wdfdevice.h)
[僅適用於 KMDF]
WdfDeviceInitSetPowerNotPageable 方法會通知電源管理員，當系統在睡眠狀態與工作 (S0) 狀態之間轉換時，驅動程式將無法存取可分頁的數據。
語法
void WdfDeviceInitSetPowerNotPageable(
[in] PWDFDEVICE_INIT DeviceInit
);
參數
[in] DeviceInit
WDFDEVICE_INIT 結構的呼叫 端提供的指標。
傳回值
無
備註
如果您的函式驅動程式或總線驅動程式呼叫 WdfDeviceInitSetPowerNotPageable，當驅動程式的裝置 進入低電源狀態 或 返回其工作狀態時，系統分頁檔案的裝置可能無法處於其運作 (D0) 狀態。 因此，在裝置的電源轉換期間，您的驅動程式不得執行任何可能導致操作系統存取分頁檔案的作業。 這類作業包括存取檔案、登錄或分頁集區。
根據預設，架構可讓您存取函式驅動程式的可分頁數據。 架構會針對總線驅動程式列舉的每個子裝置使用父裝置的設定，除非總線驅動程式呼叫 子裝置的 WdfDeviceInitSetPowerPageable 或 WdfDeviceInitSetPowerNotPageable 。 如果您撰寫的總線驅動程式會呼叫子裝置的 WdfDeviceInitSetPowerPageable ，則子裝置堆疊中沒有任何驅動程式可以呼叫 WdfDeviceInitSetPowerNotPageable。
從篩選驅動程式呼叫 WdfDeviceInitSetPowerPageable 或 WdfDeviceInitSetPowerNotPageable 沒有任何作用。 架構會使用下一個較低驅動程式所指定的設定。
大部分驅動程式不需要呼叫 WdfDeviceInitSetPowerPageable 或 WdfDeviceInitSetPowerNotPageable。 相反地，您應該讓架構使用適合您驅動程式的預設設定。 不過，如果驅動程式屬於驅動程式堆疊的一部分，則驅動程式應該呼叫 WdfDeviceInitSetPowerNotPageable ，該堆疊在電源轉換期間不得存取可分頁數據 (，例如儲存堆疊或視訊堆疊) ，或是驅動程式是列舉可能儲存或視訊裝置的總線驅動程式。
如果您的驅動程式呼叫 WdfDeviceInitSetPowerNotPageable，它必須先這麼做，才能呼叫 WdfDeviceCreate。
如需呼叫 WdfDeviceCreate 的詳細資訊，請參閱 建立 Framework 裝置物件。
範例
下列程式代碼範例會通知電源管理員，當系統在睡眠狀態與工作 (S0) 狀態之間轉換時，驅動程式將無法存取可分頁的數據。
WdfDeviceInitSetPowerNotPageable(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) |