Propriétés de l’événement
Windows Appareils portables prend en charge les propriétés d’événement suivantes.
| Propriété | VarType | Description |
|---|---|---|
| WPD_EVENT_OPTION_IS_AUTOPLAY_EVENT | VT_BOOL | Réservé pour un usage futur. |
| WPD_EVENT_OPTION_IS_BROADCAST_EVENT | VT_BOOL | Valeur booléenne qui spécifie si l’événement est diffusé sur tous les clients. Les clients peuvent recevoir cet événement en inscrivant leur rappel auprès d’IPortableDevice::Advise. |
| WPD_EVENT_PARAMETER_CHILD_HIERARCHY_CHANGED | VT_BOOL | Valeur booléenne qui spécifie si la hiérarchie enfant de l’objet a changé. Ce paramètre est utilisé pour avertir l’appelant que certains enfants de l’objet spécifié ont été ajoutés ou supprimés. En règle générale, la modification de la hiérarchie est lancée côté appareil. Les clients peuvent devoir réinscrire les enfants de ce dossier pour conserver leurs vues à jour. |
| WPD_EVENT_PARAMETER_EVENT_ID | VT_CLSID | Valeur qui identifie un événement. |
| WPD_EVENT_PARAMETER_OBJECT_CREATION_COOKIE | VT_LPWSTR | Le cookie est retourné à un client lorsqu’il demande une création d’objet en appelant la méthode IPortableDeviceContent::CreateObjectWithPropertiesAndData . Ce paramètre est ajouté comme commodité pour aider l’appelant à lier un événement ajouté à l’objet à la demande qu’il a envoyée pour créer l’objet. Le pilote renvoie ce cookie comme valeur de retour WPD_PROPERTY_OBJECT_MANAGEMENT_CONTEXT lors du traitement de la commande WPD_COMMAND_OBJECT_MANAGEMENT_CREATE_OBJECT_WITH_PROPERTIES_AND_DATA . |
| WPD_EVENT_PARAMETER_OBJECT_PARENT_PERSISTENT_UNIQUE_ID | VT_LPWSTR | Valeur qui identifie de manière unique l’objet parent. Cette propriété est similaire à WPD_OBJECT_PARENT_ID, mais cet ID ne change pas entre les sessions. |
| WPD_EVENT_PARAMETER_OPERATION_PROGRESS | VT_UI4 | Valeur qui spécifie la progression d’une opération en cours d’exécution. La valeur de cette propriété peut passer de 0 à 100, avec 100 indiquant que l’opération est terminée. |
| WPD_EVENT_PARAMETER_OPERATION_STATE | VT_UI4 | Valeur qui indique l’état actuel de l’opération, par exemple, démarré, en cours d’exécution, arrêté, et ainsi de suite. Les valeurs possibles de ce paramètre proviennent de l’énumération WPD_OPERATION_STATES définie dans PortableDevice.h. Les valeurs possibles sont les suivantes :
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 | Valeur qui spécifie l’appareil qui provient de l’événement. Il s’agit de l’identificateur d’appareil ou de service donné par le système Plug-and-Play (PnP), et est la même chaîne utilisée dans les méthodes IPortableDevice::OpenorIPortableDeviceService::Openor . |
| WPD_EVENT_PARAMETER_SERVICE_METHOD_CONTEXT | VT_LPWSTR | Chaîne utilisée par un pilote WPD pour identifier l’opération d’une méthode de service d’appareil. Les applications ne doivent pas utiliser ce paramètre directement. |
Spécifications
| Condition requise | Valeur |
|---|---|
| En-tête |
|