Partager via


commande WPD_COMMAND_STILL_IMAGE_CAPTURE_INITIATE

La commande WPD_COMMAND_STILL_IMAGE_CAPTURE_INITIATE initie une capture d’image fixe par un objet fonctionnel d’image fixe. Si un nouvel objet est créé à la suite d’une prise de photo, le pilote doit envoyer l’événement WPD_EVENT_OBJECT_ADDED .

Catégorie de commande

WPD_CATEGORY_STILL_IMAGE_CAPTURE

Paramètres

Le pilote attend les paramètres suivants :

Paramètre VarType Description
WPD_PROPERTY_COMMON_COMMAND_TARGET VT_LPWSTR Obligatoire. ID d’objet de l’objet fonctionnel de capture d’image fixe sur l’appareil qui doit prendre l’image. Chaque objet fonctionnel de capture d’image fixe peut avoir des paramètres différents et faire référence à différents matériels sur un appareil (par exemple, une caméra avant ou arrière d’un téléphone), et ce paramètre indique lequel utiliser.

Valeur renvoyée

Le pilote doit renvoyer les résultats suivants.

Résultats VarType Description
WPD_PROPERTY_COMMON_HRESULT VT_ERROR Obligatoire. HRESULT qui indique la réussite ou l’échec de l’exécution de la commande. Si l’appelant effectue une requête non valide, le pilote doit retourner HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED) et n’est pas tenu de retourner d’autres valeurs de résultat. Les codes d’erreur incluent les codes d’erreur des appareils portables Windows ou tout autre code d’erreur approprié.
WPD_PROPERTY_COMMON_DRIVER_ERROR_CODE VT_UI4 Optionnel. Code d’erreur spécifique au pilote. Cette valeur est généralement utilisée par les fournisseurs d’appareils pour améliorer le diagnostic des erreurs d’appareil lors de l’utilisation de leurs applications. Les applications à usage général l’ignorent et s’appuient uniquement sur WPD_PROPERTY_COMMON_HRESULT à la place.

Appel de méthodes

Peut être appelé directement à l’aide de IPortableDevice::SendCommand.

Spécifications

Condition requise Valeur
En-tête
PortableDevice.h

Voir aussi

Commandes