Ereigniseigenschaften
Windows Portable Geräte unterstützen die folgenden Ereigniseigenschaften.
| Eigenschaft | VarType | BESCHREIBUNG |
|---|---|---|
| WPD_EVENT_OPTION_IS_AUTOPLAY_EVENT | VT_BOOL | Für die zukünftige Verwendung reserviert. |
| WPD_EVENT_OPTION_IS_BROADCAST_EVENT | VT_BOOL | Ein boolescher Wert, der angibt, ob das Ereignis an alle Clients übertragen wird. Clients können dieses Ereignis empfangen, indem sie ihren Rückruf bei IPortableDevice::Advise registrieren. |
| WPD_EVENT_PARAMETER_CHILD_HIERARCHY_CHANGED | VT_BOOL | Ein boolescher Wert, der angibt, ob die untergeordnete Hierarchie für das -Objekt geändert wurde. Dieser Parameter wird verwendet, um den Aufrufer darüber zu benachrichtigen, dass einige der für das angegebene Objekt erstellten objekte hinzugefügt oder entfernt wurden. In der Regel wird die Hierarchieänderung auf geräteseitiger Seite initiiert. Clients müssen möglicherweise die unteren Ordner neu aufzählen, um ihre Ansichten auf dem neuesten Stand zu halten. |
| WPD_EVENT_PARAMETER_EVENT_ID | VT_CLSID | Ein -Wert, der ein Ereignis identifiziert. |
| WPD_EVENT_PARAMETER_OBJECT_CREATION_COOKIE | VT_LPWSTR | Das Cookie, das an einen Client übergeben wird, wenn er eine Objekterstellung durch Aufrufen der IPortableDeviceContent::CreateObjectWithPropertiesAndData-Methode anfing. Dieser Parameter wird der Einfachheit halber hinzugefügt, um dem Aufrufer zu helfen, ein vom Objekt hinzugefügtes Ereignis mit der Anforderung zu verknüpfen, die er zum Erstellen des Objekts gesendet hat. Der Treiber übergibt dieses Cookie als WPD_PROPERTY_OBJECT_MANAGEMENT_CONTEXT Rückgabewert bei der Verarbeitung des WPD_COMMAND_OBJECT_MANAGEMENT_CREATE_OBJECT_WITH_PROPERTIES_AND_DATA zurück. |
| WPD_EVENT_PARAMETER_OBJECT_PARENT_PERSISTENT_UNIQUE_ID | VT_LPWSTR | Ein -Wert, der das übergeordnete Objekt eindeutig identifiziert. Diese Eigenschaft ähnelt WPD_OBJECT_PARENT_ID, aber diese ID ändert sich nicht zwischen Sitzungen. |
| WPD_EVENT_PARAMETER_OPERATION_PROGRESS | VT_UI4 | Ein -Wert, der den Status eines derzeit ausgeführten Vorgangs angibt. Der Wert dieser Eigenschaft kann zwischen 0 und 100 liegen, und 100 gibt an, dass der Vorgang abgeschlossen ist. |
| WPD_EVENT_PARAMETER_OPERATION_STATE | VT_UI4 | Ein -Wert, der den aktuellen Status des Vorgangs angibt, z. B. gestartet, ausgeführt, beendet und so weiter. Die möglichen Werte dieses Parameters sind aus der WPD_OPERATION_STATES Enumeration, die in PortableDevice.h definiert ist. Mögliche Werte:
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 | Ein -Wert, der das Gerät angibt, von dem das Ereignis stammt. Dies ist die Geräte- oder Dienst-ID, die vom Plug-and-Play-System (PnP) angegeben wird, und ist die gleiche Zeichenfolge, die in den Methoden IPortableDevice::Openoder IPortableDeviceService::Open verwendet wird. |
| WPD_EVENT_PARAMETER_SERVICE_METHOD_CONTEXT | VT_LPWSTR | Eine Zeichenfolge, die von einem WPD-Treiber verwendet wird, um den Vorgang einer device-service-Methode zu identifizieren. Anwendungen sollten diesen Parameter nicht direkt verwenden. |
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Header |
|