Ereigniseigenschaften

Windows Portable Devices unterstützt 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 gesendet wird. Clients können dieses Ereignis erhalten, indem sie ihren Rückruf bei IPortableDevice::Advise registrieren.
WPD_EVENT_PARAMETER_CHILD_HIERARCHY_CHANGED	VT_BOOL	Ein boolescher Wert, der angibt, ob sich die untergeordnete Hierarchie für das Objekt geändert hat. Dieser Parameter wird verwendet, um den Aufrufer zu benachrichtigen, dass einige untergeordnete Elemente für das angegebene Objekt hinzugefügt oder entfernt wurden. In der Regel wird die Hierarchieänderung auf der Geräteseite initiiert. Clients müssen möglicherweise die untergeordneten 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 wird an einen Client zurückgegeben, wenn es eine Objekterstellung durch Aufrufen der IPortableDeviceContent::CreateObjectWithPropertiesAndData-Methode anfordert. Dieser Parameter wird als Benutzerfreundlichkeit hinzugefügt, um dem Aufrufer zu helfen, ein objektgefügtes Ereignis mit der Anforderung zu verknüpfen, die er zum Erstellen des Objekts gesendet hat. Der Treiber gibt dieses Cookie als WPD_PROPERTY_OBJECT_MANAGEMENT_CONTEXT Rückgabewert zurück, wenn der Befehl WPD_COMMAND_OBJECT_MANAGEMENT_CREATE_OBJECT_WITH_PROPERTIES_AND_DATA verarbeitet wird.
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 Fortschritt eines derzeit ausgeführten Vorgangs angibt. Der Wert dieser Eigenschaft kann zwischen 0 und 100 liegen, wobei 100 angibt, 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 usw. Die möglichen Werte dieses Parameters stammen aus der in PortableDevice.h definierten WPD_OPERATION_STATES Enumeration. Mögliche Werte: 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	Ein Wert, der das Gerät angibt, das das Ereignis ausgelöst hat. Dies ist der Geräte- oder Dienstbezeichner, der vom PnP-System (Plug-and-Play) angegeben wird, und ist dieselbe 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.

Anforderungen

Anforderung	Wert
Header	PortableDevice.h

Siehe auch

WPD-Eigenschaften und -Attribute