事件属性

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

要求

要求
标头
PortableDevice.h

另请参阅

WPD 属性和属性