Metodo IAMExtTransport::GetStatus (strmif.h)

  • Articolo

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine 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, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il GetStatus metodo restituisce informazioni sullo stato del trasporto.

Sintassi

HRESULT GetStatus(
  [in]      long StatusItem,
  [in, out] long *pValue
);

Parametri

[in] StatusItem

Specifica le informazioni sullo stato da recuperare. Per ulteriori informazioni, vedere la sezione Osservazioni.

[in, out] pValue

Puntatore a variabile che specifica o riceve un numero intero lungo , il cui significato dipende dal valore di StatusItem. 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 StatusItem è un flag che specifica le informazioni sullo stato da recuperare. Il metodo restituisce le informazioni nel parametro pValue . Non tutti i dispositivi supportano ogni flag di stato. Vengono definiti i flag seguenti:

  • ED_MODE: restituisce la modalità di trasporto corrente, ad esempio pausa o riproduzione. Per un elenco di costanti che definiscono le modalità di trasporto, vedere IAMExtTransport::p ut_Mode . In alternativa, è possibile impostare StatusItem su una di queste costanti e pValue riceverà il valore OATRUE se il trasporto è attualmente in tale modalità o OAFALSE in caso contrario.
  • ED_MEDIA_TYPE: indica il formato del supporto per questo trasporto. Restituisce una delle costanti seguenti.
    Costante Descrizione
    ED_MEDIA_VHS VHS
    ED_MEDIA_SVHS S-VHS
    ED_MEDIA_HI8 Hi-8
    ED_MEDIA_UMATIC Umatic
    ED_MEDIA_DVC Nastro DV (DVC)
    ED_MEDIA_1_INCH Nastro da 1 pollice
    ED_MEDIA_D1 Formato D1
    ED_MEDIA_D2 Formato D2
    ED_MEDIA_D3 Formato D3
    ED_MEDIA_D5 Formato D5
    ED_MEDIA_DBETA Betacam digitale
    ED_MEDIA_BETA Betacam
    ED_MEDIA_8MM 8 millimetri
    ED_MEDIA_DDR Registratore di dischi digitali
    ED_MEDIA_SX Betacam SX
    ED_MEDIA_OTHER Altro
    ED_MEDIA_CLV LaserdiscO CLV (velocità lineare costante o "riproduzione standard")
    ED_MEDIA_CAV CAV (costante Angular velocità o "gioco esteso") laserdisc
     
  • ED_LINK_MODE: restituisce OATRUE se i controlli del trasporto sono collegati ai metodi Run, Stop e Pause del grafo di filtro e OAFALSE in caso contrario. Per altre informazioni, vedere IAMExtTransport::p ut_Mode .
  • ED_MEDIA_PRESENT: restituisce OATRUE se il supporto del trasporto è presente o OAFALSE in caso contrario.
  • ED_MEDIA_LENGTH: restituisce la lunghezza del supporto, in unità di misura del formato ora corrente(vedere IAMExtTransport::SetTransportBasicParameters).
  • ED_MEDIA_TRACK_COUNT: restituisce il conteggio delle tracce.
  • ED_MEDIA_TRACK_LENGTH: restituisce la lunghezza della traccia, in unità di misura del formato dell'ora corrente.
  • ED_MEDIA_SIDE: indica quale lato del supporto è attivo.
In Windows XP Service Pack 2 e versioni successive vengono definite le modalità di riproduzione aggiuntive seguenti per ED_MODE.
Costante Descrizione
ED_MODE_PLAY_SLOW_FWD_X Riprodurre un avanzamento lento non specificato. (Riproduzione lenta in avanti alla velocità specifica del fornitore).
ED_MODE_PLAY_FAST_FWD_X Gioca in avanti veloce non specificato. (Fast-forward play at vendor-specific speed.)
ED_MODE_PLAY_SLOW_REV_X Riprodurre un rallentamento lento non specificato. (Riproduzione inversa lenta alla velocità specifica del fornitore).
ED_MODE_PLAY_FAST_REV_X Riprodurre un inverso rapido non specificato. (Riproduzione inversa veloce alla velocità specifica del fornitore).
ED_MODE_STOP_START Il trasporto viene arrestato all'inizio del nastro (o un altro mezzo di trasporto).
ED_MODE_STOP_END Il trasporto viene arrestato alla fine del nastro (o un altro mezzo di trasporto).
ED_MODE_STOP_EMERGENCY Il trasporto è stato arrestato a causa di condizioni impreviste o per evitare possibili danni al trasporto.
 

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

Implementazione DV

MSDV supporta i flag di stato seguenti:

  • ED_MODE: vedere le osservazioni precedenti.
  • ED_MEDIA_TYPE: restituisce uno dei valori seguenti.
    Costante Descrizione
    ED_MEDIA_VHS Nastro VHS.
    ED_MEDIA_DVC Nastro DV.
    ED_MEDIA_UNKNOWN Tipo sconosciuto.
    ED_MEDIA_NOT_PRESENT Il trasporto è vuoto.
     
  • ED_DEV_REMOVED_HEVENT_GET. Restituisce un handle a un evento. Il driver segnala l'evento se il dispositivo viene rimosso fisicamente dal sistema.
  • ED_DEV_REMOVED_HEVENT_RELEASE. Rilascia l'handle eventi ottenuto tramite il flag di ED_DEV_REMOVED_HEVENT_GET. Specificare l'indirizzo dell'handle nel parametro pValue.
  • ED_MODE_CHANGE_NOTIFY. Restituisce lo stato del dispositivo in pValue. Se il metodo restituisce E_PENDING, una modifica dello stato è in sospeso. È possibile usare il flag ED_NOTIFY_HEVENT_GET per ricevere una notifica al termine della modifica dello stato.
  • ED_NOTIFY_HEVENT_GET. Restituisce un handle a un evento. Il driver segnala l'evento quando il dispositivo completa una modifica della modalità.
  • ED_NOTIFY_HEVENT_RELEASE. Rilascia l'handle eventi ottenuto tramite il flag di ED_NOTIFY_HEVENT_GET. Specificare l'indirizzo dell'handle nel parametro pValue.

Implementazione della videocamera MPEG

MSTape supporta un formato multimediale aggiuntivo per il flag di ED_MEDIA_TYPE.

Costante Descrizione
ED_MEDIA_NEO Mini nastro digitale per il flusso di trasporto MPEG-2 (D-VHS).
 

Alcuni di questi flag sono definiti nel file di intestazione Xptrdefs.h.

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