WdfDeviceInitSetPowerNotPageable 函式 （wdfdevice.h）
[僅適用於 KMDF]
WdfDeviceInitSetPowerNotPageable 方法會通知電源管理員，當系統在睡眠狀態與工作 （S0） 狀態之間轉換時，驅動程式將無法存取 可分頁 數據。
語法
void WdfDeviceInitSetPowerNotPageable(
[in] PWDFDEVICE_INIT DeviceInit
);
參數
[in] DeviceInit
WDFDEVICE_INIT 結構的呼叫端提供的指標。
傳回值
沒有
言論
如果您的函式驅動程式或總線驅動程式呼叫 WdfDeviceInitSetPowerNotPageable，當驅動程式的裝置 進入低功率狀態 時，系統分頁檔案的裝置可能無法處於運作中狀態。 因此，在裝置電源轉換期間，驅動程式不得執行任何可能導致作系統存取分頁檔案的作業。 這類作業包括存取檔案、登錄或分頁集區。
根據預設，架構可讓您存取函式驅動程式的可分頁數據。 架構會針對總線驅動程式列舉的每個子裝置使用父裝置的設定，除非總線驅動程式呼叫 WdfDeviceInitSetPowerPageable 或 WdfDeviceInitSetPowerNotPageable 子裝置。 如果您撰寫的總線驅動程式會呼叫子裝置 WdfDeviceInitSetPowerPageable，則子裝置堆疊中沒有任何驅動程式可以呼叫 WdfDeviceInitSetPowerNotPageable。
從篩選驅動程式呼叫 WdfDeviceInitSetPowerPageable 或 WdfDeviceInitSetPowerNotPageable 沒有任何作用。 架構會使用下一個較低驅動程式所指定的設定。
大部分的驅動程式不需要呼叫 WdfDeviceInitSetPowerPageable 或 WdfDeviceInitSetPowerNotPageable。 相反地，您應該讓架構使用適合您驅動程式的預設設定。 不過，如果驅動程式是驅動程式在電源轉換期間無法存取可分頁數據的驅動程式堆疊（例如儲存堆棧或視訊堆棧），或驅動程式是列舉可能是儲存裝置或視訊裝置的總線驅動程式，則驅動程式應該呼叫 WdfDeviceInitSetPowerNotPageable。
如果您的驅動程式呼叫 WdfDeviceInitSetPowerNotPageable，則必須先呼叫 WdfDeviceCreate。
如需呼叫 WdfDeviceCreate的詳細資訊，請參閱 建立 Framework Device Object。
例子
下列程式代碼範例會通知電源管理員，當系統在睡眠狀態與工作 （S0） 狀態之間轉換時，驅動程式將無法存取可分頁的數據。
WdfDeviceInitSetPowerNotPageable(DeviceInit);
要求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 普遍 |
| 最低 KMDF 版本 | 1.0 |
| 標頭 | wdfdevice.h （包括 Wdf.h） |
| 連結庫 | Wdf01000.sys （請參閱架構連結庫版本控制。） |
| IRQL | <= DISPATCH_LEVEL |
| DDI 合規性規則 | ChildDeviceInitAPI（kmdf），DeviceInitAPI（kmdf），DriverCreate（kmdf），KmdfIrql （kmdf），KmdfIrql2（kmdf），KmdfIrqlExplicit（kmdf），PdoDeviceInitAPI（kmdf） |