WdfDeviceInitSetPowerInrush 函式 (wdfdevice.h)
[僅適用於 KMDF]
WdfDeviceInitSetPowerInrush 方法會通知電源管理員,指定的裝置在啟動時需要目前的內嵌。
語法
void WdfDeviceInitSetPowerInrush(
[in] PWDFDEVICE_INIT DeviceInit
);
參數
[in] DeviceInit
WDFDEVICE_INIT 結構的呼叫端提供的指標。
傳回值
沒有
言論
為了避免多載系統的電源供應器,系統會啟動一次需要目前一個電源的裝置。
如果您的驅動程式呼叫 WdfDeviceInitSetPowerInrush,架構會在電源狀態轉換期間 不可分頁,而且驅動程式不得呼叫 WdfDeviceInitSetPowerPageable。
您的驅動程式必須先呼叫 WdfDeviceInitSetPowerInrush,才能呼叫 WdfDeviceCreate。 如需呼叫 WdfDeviceCreate的詳細資訊,請參閱 建立 Framework Device Object。
從篩選驅動程式呼叫 WdfDeviceInitSetPowerInrush 沒有任何作用。 針對篩選驅動程式,架構會使用驅動程式堆疊中下一個較低驅動程式所指定的設定。
例子
下列程式代碼範例會通知電源管理員裝置在啟動時需要目前狀態。
WdfDeviceInitSetPowerInrush(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) |