PoFxUnregisterDevice 函式 (wdm.h)

PoFxUnregisterDevice 例程會從電源管理架構中移除裝置的註冊, (PoFx) 。

語法

void PoFxUnregisterDevice(
  [in] POHANDLE Handle
);

參數

[in] Handle

句柄,表示向PoFx註冊裝置。 裝置驅動程式先前已從 PoFxRegisterDevice 例程收到此句柄。

傳回值

備註

擁有裝置電源原則的驅動程序必須在移除裝置時,從 PoFx 取消註冊裝置。 隨插即用 (PnP) 管理員只能在裝置取消註冊之後,從 PnP 樹狀結構移除裝置堆疊。

若要取消註冊裝置,驅動程式會在處理IRP_MN_REMOVE_DEVICEIRP_MN_SURPRISE_REMOVAL要求期間呼叫 PoFxUnregisterDevice,無論第一次收到。 此呼叫應該會在驅動程式不再需要存取裝置的硬體之後發生。

呼叫此例程的裝置驅動程式之前必須呼叫 PoFxRegisterDevice 例程,才能向PoFx註冊裝置。

規格需求

需求
最低支援的用戶端 從 Windows 8 開始提供。
目標平台 Universal
標頭 wdm.h
程式庫 Ntoskrnl.lib
Dll Ntoskrnl.exe
IRQL PASSIVE_LEVEL

另請參閱

IRP_MN_REMOVE_DEVICE

IRP_MN_SURPRISE_REMOVAL

PoFxRegisterDevice