Metodo IAMExtTransport::GetCapability (strmif.h)
[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture 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 GetCapability metodo recupera le funzionalità generali del trasporto.
Sintassi
HRESULT GetCapability(
[in] long Capability,
[out] long *pValue,
[out] double *pdblValue
);
Parametri
[in] Capability
Specifica la funzionalità da controllare. Per ulteriori informazioni, vedere la sezione Osservazioni.
[out] pValue
Puntatore a una variabile che riceve un intero lungo . Per ulteriori informazioni, vedere la sezione Osservazioni.
[out] pdblValue
Puntatore a una variabile che riceve un doppio. Per ulteriori 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 .
Commenti
Il parametro Capability è un flag che specifica la funzionalità da 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_TRANSCAP_CAN_ASSEMBLE | Il trasporto può usare la modalità di montaggio dei record (registrare nuove tracce che si collegano senza problemi alla traccia del controllo dal segmento registrato in precedenza). |
| ED_TRANSCAP_CAN_BUMP_PLAY | Il trasporto può essere sincronizzato in base alla velocità variabile. |
| ED_TRANSCAP_CAN_DELAY_AUDIO_IN | Il trasporto può eseguire modifiche audio ritardate. |
| ED_TRANSCAP_CAN_DELAY_AUDIO_OUT | Il trasporto può eseguire modifiche audio ritardate. |
| ED_TRANSCAP_CAN_DELAY_VIDEO_IN | Il trasporto può eseguire modifiche video ritardate. |
| ED_TRANSCAP_CAN_DELAY_VIDEO_OUT | Il trasporto può eseguire modifiche video ritardate. |
| ED_TRANSCAP_CAN_DETECT_LENGTH | Il trasporto può rilevare la lunghezza del supporto. |
| ED_TRANSCAP_CAN_EJECT | Il trasporto può espellere i supporti. |
| ED_TRANSCAP_CAN_FREEZE | Il trasporto può bloccarsi o sospendere. |
| ED_TRANSCAP_CAN_INSERT | Il trasporto può usare la modalità di inserimento del record (registrare singole tracce mentre è bloccata in una traccia di controllo prerecordata). |
| ED_TRANSCAP_CAN_PLAY_BACKWARDS | Il trasporto può giocare indietro. |
| ED_TRANSCAP_CAN_SET_EE | Il trasporto può visualizzare l'input del dispositivo sull'output. |
| ED_TRANSCAP_CAN_SET_PB | Il trasporto può mostrare la riproduzione multimediale sul relativo output. |
| ED_TRANSCAP_FIELD_STEP | Il trasporto risponde a un comando di avanzamento frame avanzando un campo. |
| ED_TRANSCAP_HAS_CLOCK | Il dispositivo ha un orologio. |
| ED_TRANSCAP_HAS_DT | Il dispositivo ha il rilevamento dinamico. |
| ED_TRANSCAP_HAS_TIMER | Il dispositivo ha un timer. |
| ED_TRANSCAP_HAS_TUNER | Il dispositivo ha un tuner. |
| ED_TRANSCAP_IS_MASTER | Il dispositivo è l'orologio master per la sincronizzazione. |
| ED_TRANSCAP_MULTIPLE_EDITS | Il dispositivo supporta più eventi di modifica. |
| ED_TRANSCAP_NEEDS_CUEING | Il dispositivo deve essere cuedo prima di eseguire una modifica. |
| ED_TRANSCAP_NEEDS_TBC | Il dispositivo deve essere calibrato. |
Per i flag seguenti, il metodo restituisce un valore numerico nel parametro pValue .
| Flag di funzionalità | Valore restituito |
| ED_TRANSCAP_LTC_TRACK | Restituisce il numero di traccia del codice di tempo LTC o ED_ALL se non è presente alcuna traccia timecode dedicata. |
| ED_TRANSCAP_NUM_AUDIO_TRACKS | Restituisce il numero di tracce audio. |
Per i flag seguenti, il metodo restituisce un valore nel parametro pdblValue .
| Flag di funzionalità | Valore restituito |
| ED_TRANSCAP_FWD_SHUTTLE_MAX | Velocità massima in avanti in modalità navetta, come più velocità di gioco. |
| ED_TRANSCAP_FWD_SHUTTLE_MIN | Velocità minima in avanti in modalità navetta, come una velocità di riproduzione multipla. |
| ED_TRANSCAP_FWD_VARIABLE_MAX | Velocità massima in avanti, come più velocità di gioco. |
| ED_TRANSCAP_FWD_VARIABLE_MIN | Velocità minima di avanzamento, come più velocità di gioco. |
| ED_TRANSCAP_REV_SHUTTLE_MAX | Velocità inversa massima in modalità navetta, come una velocità di gioco multipla. |
| ED_TRANSCAP_REV_SHUTTLE_MIN | Velocità minima inversa in modalità navetta, come più velocità di gioco. |
| ED_TRANSCAP_REV_VARIABLE_MAX | Velocità inversa massima, come velocità di gioco multipla. |
| ED_TRANSCAP_REV_VARIABLE_MIN | Velocità minima inversa, come più velocità di gioco. |
Implementazione DV
MSDV non supporta questo metodo. Restituisce E_NOTIMPL.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | strmif.h (include Dshow.h) |
| Libreria | Strmiids.lib |