事件属性

Windows可移植设备支持以下事件属性。

properties 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,但此 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_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::OpenorIPortableDeviceService::Open 方法中使用的字符串相同。
WPD_EVENT_PARAMETER_SERVICE_METHOD_CONTEXT VT_LPWSTR WPD 驱动程序用于标识设备服务方法操作的字符串。 应用程序不应直接使用此参数。

要求

要求 Value
标头
PortableDevice.h

另请参阅

WPD 属性和属性