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_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, 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
PortableDevice.h

Weitere Informationen

WPD-Eigenschaften und -Attribute