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)

另請參閱

WdfDeviceInitSetPowerPageable