befehl WPD_COMMAND_STILL_IMAGE_CAPTURE_INITIATE
Der befehl WPD_COMMAND_STILL_IMAGE_CAPTURE_INITIATE initiiert eine Standbilderfassung durch ein funktionsbezogenes Objekt des Standbilds. Wenn ein neues Objekt als Ergebnis der Aufnahme eines Bilds erstellt wird, sollte der Treiber das WPD_EVENT_OBJECT_ADDED-Ereignis senden.
Befehlskategorie
WPD_CATEGORY_STILL_IMAGE_CAPTURE
Parameter
Der Treiber erwartet die folgenden Parameter.
| Parameter | VarType | BESCHREIBUNG |
|---|---|---|
| WPD_PROPERTY_COMMON_COMMAND_TARGET | VT_LPWSTR | Erforderlich. Die Objekt-ID des Funktionsobjekts für die Standbilderfassung auf dem Gerät, das das Bild aufnehmen soll. Jedes Funktionsobjekt für die Standbilderfassung kann unterschiedliche Einstellungen aufweisen und sich möglicherweise auf unterschiedliche Hardware auf einem Gerät beziehen (z. B. eine Front- oder Rückkamera eines Smartphones), und dieser Parameter gibt an, welches verwendet werden soll. |
Rückgabewert
Als Ergebnisse des Treibers werden erwartet:
| Ergebnis | VarType | BESCHREIBUNG |
|---|---|---|
| WPD_PROPERTY_COMMON_HRESULT | VT_ERROR | Erforderlich. Ein HRESULT,das angibt, dass der Befehl erfolgreich oder nicht ausgeführt wurde. Wenn der Aufrufer eine ungültige Anforderung sendet, sollte der Treiber HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED) zurückgeben und muss keine anderen Ergebniswerte zurückgeben. Fehlercodes umfassen Fehlercodes für windows Portable Devices oder andere geeignete Fehlercodes. |
| WPD_PROPERTY_COMMON_DRIVER_ERROR_CODE | VT_UI4 | Optional. Ein treiberspezifischer Fehlercode. Dieser Wert wird in der Regel von Geräteherstellern verwendet, um die Diagnose von Gerätefehlern bei der Verwendung ihrer Anwendungen zu verbessern. Universell einsetzbare Anwendungen würden sie ignorieren und sich stattdessen ausschließlich auf WPD_PROPERTY_COMMON_HRESULT verlassen. |
Aufrufen von Methoden
Kann nur mit IPortableDevice::SendCommand direkt aufgerufen werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|