Metodo IAMExtDevice::GetCapability (strmif.h)

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEnginee Acquisizione audio/video in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente di usare un nuovo codice MediaPlayer, IMFMediaEngine e Acquisizione audio/video in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il metodo GetCapability recupera le funzionalità del dispositivo esterno.

Sintassi

HRESULT GetCapability(
  [in]  long   Capability,
  [out] long   *pValue,
  [out] double *pdblValue
);

Parametri

[in] Capability

Specifica la funzionalità da controllare. Per altre informazioni, vedere La sezione Osservazioni.

[out] pValue

Puntatore a una variabile che riceve un intero long. Per altre informazioni, vedere La sezione Osservazioni.

[out] pdblValue

Puntatore a una variabile che riceve un doppio. Per altre informazioni, vedere La sezione Osservazioni.

Valore restituito

Quando questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT.

Osservazioni

Il parametro capability è un flag che specifica quale funzionalità controllare. Il metodo restituisce il risultato nel parametro pValue o nel parametro pdblValue , a seconda del flag di funzionalità.

Per i flag seguenti, il metodo restituisce il valore OATRUE o OAFALSE nel parametro pValue. Il valore OATRUE indica che la funzionalità è presente, mentre il valore OAFALSE indica che è assente.

Flag di funzionalità	Descrizione
ED_DEVCAP_AUDIO_INPUTS	Il dispositivo accetta input audio.
ED_DEVCAP_CAN_MONITOR_SOURCES	Il dispositivo può inviare qualsiasi input all'output monitorato, indipendentemente dall'input attualmente selezionato.
ED_DEVCAP_CAN_PREVIEW	Il dispositivo può visualizzare l'anteprima.
ED_DEVCAP_CAN_RECORD	Il dispositivo può registrare.
ED_DEVCAP_CAN_RECORD_STROBE	Il dispositivo può registrare strobe. Questa funzionalità si applica ai dispositivi multitraccia che possono registrare in tracce selezionate.
ED_DEVCAP_CAN_SAVE	Il dispositivo può salvare i dati.
ED_DEVCAP_CTLTRK_READ	Il dispositivo può leggere le tracce di controllo.
ED_DEVCAP_HAS_AUDIO	Il dispositivo ha audio.
ED_DEVCAP_HAS_VIDEO	Il dispositivo ha un video.
ED_DEVCAP_INDEX_READ	Il dispositivo può leggere i contrassegni di indice.
ED_DEVCAP_NEEDS_CALIBRATING	Il dispositivo deve calibrare. Vedere IAMExtDevice::Calibrate.
ED_DEVCAP_TIMECODE_READ	Il dispositivo può leggere il codice ora SMPTE.
ED_DEVCAP_TIMECODE_WRITE	Il dispositivo può impostare il codice ora SMPTE.
ED_DEVCAP_USES_FILES	Il dispositivo ha un file system predefinito.
ED_DEVCAP_VIDEO_INPUTS	Il dispositivo accetta l'input video.

 

Per i flag seguenti, il metodo restituisce una costante definita nel parametro pValue.

ED_DEVCAP_DEVICE_TYPE: restituisce il tipo di dispositivo.

Costante restituita	Descrizione
ED_DEVTYPE_ATR	Registratore di nastri audio
ED_DEVTYPE_CG	Generatore di caratteri
ED_DEVTYPE_DDR	Registratore di dischi digitali
ED_DEVTYPE_DVE	Unità effetti video digitali
ED_DEVTYPE_GPI	Trigger dell'interfaccia per utilizzo generico
ED_DEVTYPE_KEYER	Keyer video
ED_DEVTYPE_LASERDISK	Laserdisc
ED_DEVTYPE_MIXER_AUDIO	Mixer audio
ED_DEVTYPE_MIXER_VIDEO	Mixer video
ED_DEVTYPE_ROUTER	Router video
ED_DEVTYPE_TBC	Correttore timebase
ED_DEVTYPE_TCG	Generatore/lettore timecode
ED_DEVTYPE_VCR	VCR o windows con funzionalità VCR complete
ED_DEVTYPE_WIPEGEN	Generatore di cancellazione video
ED_DEVTYPE_JOYSTICK	Joystick
ED_DEVTYPE_KEYBOARD	Tastiera

 

ED_DEVCAP_SYNC_ACCURACY: restituisce un'indicazione dell'accuratezza della sincronizzazione del dispositivo.

Costante restituita	Descrizione
ED_SYNCACC_PRECISE	Il dispositivo ha una precisione precisa.
ED_SYNCACC_FRAME	Il dispositivo è accurato per i fotogrammi.
ED_SYNCACC_ROUGH	Il dispositivo è minore del frame accurato.

 

ED_DEVCAP_NORMAL_RATE: restituisce la frequenza normale dei fotogrammi del dispositivo.

Costante restituita	Descrizione
ED_RATE_24	24 fotogrammi al secondo (fps)
ED_RATE_25	25 fps
ED_RATE_2997	29,97 fps
ED_RATE_30	30 fps

 

ED_DEVCAP_SEEK_TYPE: restituisce un'indicazione dell'accuratezza della ricerca del dispositivo.

Costante restituita	Descrizione
ED_SEEK_PERFECT	Il dispositivo può cercare all'interno di un fotogramma video senza interruzione del segnale.
ED_SEEK_FAST	Il dispositivo può cercare rapidamente, con una breve interruzione nel segnale.
ED_SEEK_SLOW	Il dispositivo cerca lentamente; ad esempio il trasporto su nastro.

 

Per i flag seguenti, il metodo restituisce un valore numerico nel parametro pValue.

Flag di funzionalità	Valore restituito
ED_DEVCAP_EXTERNAL_DEVICE_ID	Identificatore specifico del produttore.
ED_DEVCAP_PREROLL	Tempo di preroll del dispositivo.
ED_DEVCAP_POSTROLL	Tempo di postroll del dispositivo.

 

In Windows XP Service Pack 2 e versioni successive sono supportati i flag aggiuntivi seguenti per ED_DEVCAP_DEVICE_TYPE.

Costante restituita	Descrizione
ED_DEVTYPE_CAMERA_STORAGE	Archiviazione per immagini ancora o file video brevi.
ED_DEVTYPE_DTV	Televisione digitale con interfaccia del bus seriale.
ED_DEVTYPE_PC_VIRTUAL	Dispositivo virtuale o emulato in un computer.

 

Per usare queste costanti, includere il file di intestazione Xprtdefs.h.

Implementazione DV

I driver MSDV e UVC supportano i comportamenti seguenti.

Il flag ED_DEVCAP_NORMAL_RATE restituisce la frequenza dei fotogrammi.

Costante restituita	Descrizione
ED_RATE_25	25 fps (frequenza dei fotogrammi PAL predefinita)
ED_RATE_2997	29,997 fps (frequenza dei fotogrammi NTSC predefinita)

 

Solo per MSDV, il flag ED_DEVCAP_DEVICE_TYPE restituisce il tipo di dispositivo. I valori possibili sono illustrati nella tabella seguente. Per i dispositivi UVC, usare invece l'interfaccia IKsTopologyInfo .

Costante restituita	Descrizione
ED_DEVTYPE_CAMERA	Fotocamera semplice che può registrare o sospendere il record, ma non dispone di funzionalità VCR complete.
ED_DEVTYPE_DVHS	Il dispositivo supporta il formato D-VHS.
ED_DEVTYPE_UNKNOWN	Tipo di dispositivo sconosciuto.
ED_DEVTYPE_VCR	Il dispositivo ha funzionalità complete di VCR.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	strmif.h (include Dshow.h)
libreria	Strmiids.lib

Vedere anche

codici di errore e di esito positivo

interfaccia IAMExtDevice