KSPROPERTY_CAMERACONTROL_S_EX struttura (ksmedia.h)

Articolo
02/29/2024

Specifica un'operazione di controllo della fotocamera, inclusa l'impostazione del flash, le proprietà del controllo del pin immagine, l'area di interesse per l'immagine o la stabilizzazione video. Questa struttura descrive le proprietà basate sui filtri nel set di proprietà PROPSETID_VIDCAP_CAMERACONTROL .

Supportato a partire da Windows 8.

Sintassi

typedef struct {
  KSPROPERTY Property;
  LONG       Value;
  ULONG      Flags;
  ULONG      Capabilities;
  RECT       FocusRect;
} KSPROPERTY_CAMERACONTROL_S_EX, *PKSPROPERTY_CAMERACONTROL_S_EX;

Members

Property

Specifica una struttura KSPROPERTY inizializzata che descrive il set di proprietà, l'ID proprietà e il tipo di richiesta.

Value

Specifica il valore della proprietà. Questo membro è di lettura/scrittura.

Flags

Indica, per Ottenere le richieste, l'impostazione corrente per la proprietà specificata dai valori elencati di seguito. Indica, per Impostare le richieste, l'impostazione desiderata per la proprietà specificata dai valori elencati di seguito. Questo membro può essere un OR bit per bit dei valori seguenti definiti in Ksmedia.h:

Valore	Descrizione
KSPROPERTY_CAMERACONTROL_FLAGS_AUTO	Indica che l'impostazione è controllata automaticamente. Se il driver riceve questo valore, deve impostare il controllo della fotocamera in modo sincrono sulla modalità automatica e quindi restituire.
KSPROPERTY_CAMERACONTROL_FLAGS_MANUAL	Indica che l'impostazione è controllata manualmente. Se il driver riceve questo valore, deve impostare il controllo della fotocamera in modo sincrono sulla modalità manuale e quindi restituire.
KSPROPERTY_CAMERACONTROL_FLAGS_ASYNCHRONOUS	Indica se il driver deve eseguire l'operazione di controllo della fotocamera in modo asincrono, dove l'applicazione ha rilasciato un comando per il driver per configurare le impostazioni del controllo della fotocamera in anticipo di scattare un'immagine. Questo flag deve essere impostato solo se sono impostate KSPROPERTY_CAMERACONTROL_FLAGS_MANUAL o KSPROPERTY_CAMERACONTROL_FLAGS_AUTO . Se questo valore di flag e il valore del flag di KSPROPERTY_CAMERACONTROL_FLAGS_AUTO sono entrambi impostati, il driver deve avviare un thread di lavoro per avviare un'operazione di controllo richiesta e deve rifiutare tutte le altre richieste per la stessa operazione finché non è stata completata la prima. Al termine dell'operazione, il driver deve attivare l'evento KSEVENTSETID_CameraAsyncControl .

Capabilities

Se impostato, indica che quando l'applicazione invia una query, il driver deve restituire il valore del membro Capabilities della struttura di controllo della fotocamera appropriata dall'elenco seguente.

FocusRect

Struttura RECT che specifica l'area rettangolare in cui il dispositivo deve impostare lo stato attivo. Questa struttura è disponibile solo per le applicazioni desktop di Windows.

Commenti

Quando un'operazione di messa a fuoco della fotocamera richiesta viene completata o annullata, il driver deve generare un evento specificato dal valore di enumerazione KSEVENT_CAMERACONTROL_FOCUS .