Metodo IAMExtTransport::SetTransportBasicParameters (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 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.

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 una stringa nel parametro pszData .

Implementazione DV

MSDV non supporta questo metodo. Restituisce E_NOTIMPL.

Requisiti

Vedi anche

Codici errore e esito positivo

Interfaccia IAMExtTransport

IAMExtTransport::GetTransportBasicParameters