Metodo IAMExtTransport::SetTransportBasicParameters (strmif.h)

  • Articolo

[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 SetTransportBasicParameters metodo imposta proprietà generali del trasporto.

Sintassi

HRESULT SetTransportBasicParameters(
  [in] long      Param,
  [in] long      Value,
  [in] LPCOLESTR pszData
);

Parametri

[in] Param

Specifica la proprietà da impostare. Per ulteriori informazioni, vedere la sezione Osservazioni.

[in] Value

Specifica il valore della proprietà come intero lungo . Per ulteriori informazioni, vedere la sezione Osservazioni.

[in] pszData

Specifica il valore della proprietà come LPOLESTR. 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 . I codici di errore possibili includono quanto segue.

Codice restituito Descrizione
E_NOTIMPL
 Il dispositivo non supporta l'impostazione di questa proprietà.
ERROR_DEVICE_REMOVED
 Il dispositivo è stato rimosso.

Commenti

Il parametro Param è un flag che specifica la proprietà da impostare. Per alcuni flag, la proprietà è numerica; usare il parametro Value per specificare il valore. Per altri flag, la proprietà è una stringa; usare il parametro pszData per specificare il valore. In entrambi i casi, il metodo ignora l'altro parametro.

Per i flag seguenti, il parametro Value accetta una costante definita.

  • ED_TRANSBASIC_TIME_FORMAT: specifica il formato ora.
    Costante Descrizione
    ED_FORMAT_MILLISECONDS Millisecondi.
    ED_FORMAT_FRAMES Fotogrammi.
    ED_FORMAT_REFERENCE_TIME Ora di riferimento.
    ED_FORMAT_HMSF Decimale codificato binario, che rappresenta ore, minuti, secondi e fotogrammi.
    ED_FORMAT_TMSF Decimale codificato binario, che rappresenta tracce, minuti, secondi e fotogrammi.
     
  • ED_TRANSBASIC_TIME_REFERENCE: specifica l'ora di riferimento in uso dal dispositivo.
    Costante Descrizione
    ED_TIMEREF_TIMECODE Codice temporale.
    ED_TIMEREF_CONTROL_TRACK Traccia del controllo.
    ED_TIMEREF_INDEX Index.
    ED_TIMEREF_ATN Numero di traccia assoluto. Questa costante è definita nel file di intestazione Xprtdefs.h.
     
  • ED_TRANSBASIC_END_STOP_ACTION: specifica l'azione eseguita dal dispositivo quando raggiunge la fine del mezzo di trasporto.
    Costante Descrizione
    ED_MODE_STOP Interrompere.
    ED_MODE_REWIND Riavvolgimento.
    ED_MODE_FREEZE Blocca/sospende.
     
  • ED_TRANSBASIC_RECORD_FORMAT: specifica la velocità di registrazione.
    Costante Descrizione
    ED_RECORD_FORMAT_SP Gioco standard.
    ED_RECORD_FORMAT_LP Gioco lungo.
    ED_RECORD_FORMAT_EP Gioco esteso.
     
  • ED_TRANSBASIC_SUPERIMPOSE: specifica se la visualizzazione sullo schermo è abilitata o disabilitata.
    Costante Descrizione
    OATRUE La visualizzazione sullo schermo è abilitata.
    OAFALSE La visualizzazione sullo schermo è disabilitata.
     
  • ED_TRANSBASIC_STEP_UNIT: specifica l'unità di passaggio.
    Costante Descrizione
    ED_STEP_FIELD Campi.
    ED_STEP_FRAME Fotogrammi.
    ED_STEP_3_2 3/2 Pulldown.
     
  • ED_TRANSBASIC_SET_COUNTER_FORMAT: imposta il formato dell'ora per il contatore. Per i valori possibili, vedere il flag ED_TRANSBASIC_TIME_FORMAT.
Per i flag seguenti, usare un valore numerico nel parametro Value .
Flag Descrizione
ED_TRANSBASIC_STEP_COUNT Specifica il conteggio dei passaggi, in unità definite dal flag di ED_TRANSBASIC_STEP_UNIT.
ED_TRANSBASIC_SET_FREEZE_TIMEOUT Specifica il timeout per la modalità di blocco, in unità del formato ora corrente.
ED_TRANSBASIC_SETCLOCK Imposta l'ora dell'orologio.
ED_TRANSBASIC_SET_COUNTER_VALUE Imposta il valore del contatore.
 

Per i flag seguenti, usare una stringa nel parametro pszData .

Flag Descrizione
ED_TRANSBASIC_VOLUME_NAME Specifica il nome del volume.
 

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

IAMExtTransport::GetTransportBasicParameters