事件屬性

Windows 可攜式裝置支援下列事件屬性。

屬性 VarType Description
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 中定義的 WPD_OPERATION_STATES 列舉。 可能的值包括:
WPD_OPERATION_STATE_UNSPECIFIED
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:: openIPortableDeviceService:: open 方法中使用的字串相同。
WPD_EVENT_PARAMETER_SERVICE_METHOD_CONTEXT VT_LPWSTR WPD 驅動程式用來識別裝置服務方法之作業的字串。 應用程式不應直接使用此參數。

規格需求

需求
標頭
PortableDevice。h

另請參閱

WPD 屬性和屬性