IObjectCleanup：：OnCleanup 方法 (wudfddi.h)

[警告： UMDF 2 是最新版的 UMDF，並取代 UMDF 1。 所有新的 UMDF 驅動程式都應該使用 UMDF 2 來撰寫。 未將新功能新增至 UMDF 1，而且較新版本的 Windows 10 上，UMDF 1 的支援有限。 通用 Windows 驅動程式必須使用 UMDF 2。 如需詳細資訊，請參閱使用 UMDF 使用者入門。]

OnCleanup 方法會釋放 WDF 物件的任何參考，以防止介面外洩。

語法

void OnCleanup(
  [in] IWDFObject *pWdfObject
);

參數

[in] pWdfObject

即將釋放之物件的 IWDFObject 介面指標。

傳回值

無

備註

架構會呼叫 OnCleanup 作為 WDF 物件解構序列的一部分。 架構會在終結 WDF 物件之前呼叫 OnCleanup 。

當驅動程式呼叫下列任何建立 WDF 物件或將內容指派給 WDF 物件的方法時，驅動程式可以註冊 IObjectCleanup 介面：

• IWDFDevice：：CreateIoQueue

• IWDFDevice：：CreateRequest

• IWDFDriver：：CreateDevice

• IWDFDriver：：CreatePreallocatedWdfMemory

• IWDFDriver：：CreateWdfMemory

• IWDFDriver：：CreateWdfObject

• IWDFObject：：AssignContext

規格需求

需求	值
目標平台	Windows
標頭	wudfddi.h (包括 Wudfddi.h)

另請參閱

IObjectCleanup

IWDFDevice：：CreateIoQueue

IWDFDevice：：CreateRequest

IWDFDriver：：CreateDevice

IWDFDriver：：CreatePreallocatedWdfMemory

IWDFDriver：：CreateWdfMemory

IWDFDriver：：CreateWdfObject

IWDFObject

IWDFObject：：AssignContext