WUDF_WORKITEM_FUNCTION回呼函式 (wudfworkitem.h)
[警告: UMDF 2 是最新版的 UMDF,並取代 UMDF 1。 所有新的 UMDF 驅動程式都應該使用 UMDF 2 來撰寫。 未將新功能新增至 UMDF 1,且較新版本的 #DB6ACF90C55A14A19889C8C1538914526 上不支援 UMDF 1。 通用 Windows 驅動程式必須使用 UMDF 2。 如需詳細資訊,請參閱使用 UMDF 使用者入門。]
驅動程式的 OnWorkItem 事件回呼函式會執行與指定工作專案相關聯的工作。
語法
WUDF_WORKITEM_FUNCTION WudfWorkitemFunction;
void WudfWorkitemFunction(
[in] IWDFWorkItem *pWorkItem
)
{...}
參數
[in] pWorkItem
IWDFWorkItem 介面的指標。
傳回值
無
備註
若要註冊 OnWorkItem 回呼函式,您的驅動程式必須在呼叫 IWDFDevice3::CreateWorkItem 之前,將回呼函式的位址放在WUDF_WORKITEM_CONFIG結構中。
一般而言,驅動程式的 OnWorkItem 回呼函式會執行工作,這些工作是由驅動程式儲存在工作專案對象內容記憶體中的資訊所指定。
驅動程式不得從 OnWorkItem 回呼函式呼叫 IWDFObject::D eleteWdfObject。
如需詳細資訊,請參閱 使用工作專案。
範例
函式類型會在 Wudfworkitem.h 中宣告,如下所示。
typedef
VOID
WUDF_WORKITEM_FUNCTION(
_In_
IWDFWorkItem* pWorkItem
);
typedef WUDF_WORKITEM_FUNCTION *PFN_WUDF_WORKITEM;
若要定義名為 MyWorkItem 的 OnWorkItem 回呼函式,您必須先提供 SDV 和其他驗證工具所需的函式宣告,如下所示:
WUDF_WORKITEM_FUNCTION MyWorkItem;
然後,實作您的回呼函式,如下所示:
VOID
MyWorkItem (
_In_
IWDFWorkItem* pWorkItem
)
{…}
規格需求
需求 | 值 |
---|---|
終止支援 | UMDF 2.0 和更新版本中無法使用。 |
目標平台 | 桌面 |
最低UMDF版本 | 1.11 |
標頭 | wudfworkitem.h |