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

Vedi anche

Codici errore e esito positivo

Interfaccia IAMExtTransport