事件屬性
Windows可攜式裝置支援下列事件屬性。
屬性 | VarType | 描述 |
---|---|---|
WPD_EVENT_OPTION_IS_AUTOPLAY_EVENT | VT_BOOL | 保留供未來使用。 |
WPD_EVENT_OPTION_IS_BROADCAST_EVENT | VT_BOOL | 布林值,指定事件是否廣播至所有用戶端。用戶端可以使用 IPortableDevice::Advise註冊其回呼來接收此事件。 |
WPD_EVENT_PARAMETER_CHILD_HIERARCHY_CHANGED | VT_BOOL | 布林值,指定 物件的子階層是否已變更。這個參數是用來通知呼叫端,指定的物件的某些子系已加入或移除。 一般而言,階層變更會在裝置端起始。 用戶端可能必須重新列舉此資料夾的子系,才能讓其檢視保持最新狀態。 |
WPD_EVENT_PARAMETER_EVENT_ID | VT_CLSID | 識別事件的 值。 |
WPD_EVENT_PARAMETER_OBJECT_CREATION_COOKIE | VT_LPWSTR | 當 Cookie 要求物件建立時,會呼叫 IPortableDeviceContent::CreateObjectWithPropertiesAndData 方法,將 Cookie 傳回給用戶端。這個參數會新增為方便,以協助呼叫端將物件新增的事件系結至它傳送來建立物件的要求。 驅動程式會在處理WPD_COMMAND_OBJECT_MANAGEMENT_CREATE_OBJECT_WITH_PROPERTIES_AND_DATA命令時,將此 Cookie 交回為WPD_PROPERTY_OBJECT_MANAGEMENT_CONTEXT傳回值。 |
WPD_EVENT_PARAMETER_OBJECT_PARENT_PERSISTENT_UNIQUE_ID | VT_LPWSTR | 可唯一識別父物件的 值。 此屬性類似于 WPD_OBJECT_PARENT_ID,但此識別碼不會在會話之間變更。 |
WPD_EVENT_PARAMETER_OPERATION_PROGRESS | VT_UI4 | 值,指定目前執行中作業的進度。 這個屬性的值可以介於 0 到 100 之間,100 表示作業已完成。 |
WPD_EVENT_PARAMETER_OPERATION_STATE | VT_UI4 | 值,表示作業的目前狀態,例如已啟動、執行中、已停止等等。此參數的可能值來自 PortableDevice.h 中定義的 WPD_OPERATION_STATES 列舉。 可能的值包括:
WPD_OPERATION_STATE_STARTED WPD_OPERATION_STATE_RUNNING WPD_OPERATION_STATE_PAUSED WPD_OPERATION_STATE_CANCELLED WPD_OPERATION_STATE_FINISHED WPD_OPERATION_STATE_ABORTED |
WPD_EVENT_PARAMETER_PNP_DEVICE_ID | VT_LPWSTR | 值,指定產生事件的裝置。這是隨插即用 (PnP) 系統所提供的裝置或服務識別碼,而且與 IPortableDevice::OpenorIPortableDeviceService::Open 方法中使用的字串相同。 |
WPD_EVENT_PARAMETER_SERVICE_METHOD_CONTEXT | VT_LPWSTR | WPD 驅動程式用來識別裝置服務方法作業的字串。 應用程式不應該直接使用此參數。 |
規格需求
需求 | 值 |
---|---|
標頭 |
|