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
Per i flag seguenti, il metodo restituisce il valore OATRUE o OAFALSE nel parametro
| 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
| 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 |