事件属性
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_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::Open或 IPortableDeviceService::Open 方法中使用的字符串相同。 |
WPD_EVENT_PARAMETER_SERVICE_METHOD_CONTEXT | VT_LPWSTR | WPD 驱动程序用于标识设备服务方法操作的字符串。 应用程序不应直接使用此参数。 |
要求
要求 | 值 |
---|---|
标头 |
|
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈