Metodo IAMExtTransport::GetStatus (strmif.h)
[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.
| 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 |