Metodo IAMExtTransport::GetTransportBasicParameters (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 GetTransportBasicParameters metodo recupera le proprietà generali del trasporto esterno.

Sintassi

HRESULT GetTransportBasicParameters(
  [in]      long     Param,
  [in, out] long     *pValue,
  [in, out] LPOLESTR *ppszData
);

Parametri

[in] Param

Specifica la proprietà da ricevere.

[in, out] pValue

Puntatore a una variabile che riceve un valore intero lungo . Per ulteriori informazioni, vedere la sezione Osservazioni.

[in, out] ppszData

Puntatore a una variabile di tipo LPOLESTR che riceve una stringa. 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 Param è un flag che specifica la proprietà da recuperare. Alcune proprietà sono numeriche; questi vengono restituiti nel parametro pValue . Altre proprietà sono valori stringa; questi vengono restituiti nel parametro ppszData . Per un elenco di flag e valori previsti, vedere IAMExtTransport::SetTransportBasicParameters.

Se il metodo restituisce una stringa, il chiamante deve liberare la stringa usando la funzione CoTaskMemFree .

Implementazione dv e mpeg-

MSDV supporta i flag aggiuntivi seguenti:

• ED_RAW_EXT_DEV_CMD: richiama un comando AV/C non elaborato. Specificare il comando AV/C come matrice di byte nel parametro ppszData . Specificare le dimensioni del comando, in byte, nel parametro pValue . Quando il metodo restituisce il risultato, ppszData contiene la risposta dal dispositivo e pValue contiene le dimensioni della risposta, in byte. Il comando AV/C viene passato direttamente al dispositivo senza convalida o controllo degli errori.

  Il payload della risposta potrebbe essere maggiore del comando . È responsabilità del chiamante allocare spazio sufficiente nel buffer per la risposta. La dimensione massima del payload è di 512 byte.

  Per altre informazioni, vedere Rilascio di comandi AV/C non elaborati.

• ED_TRANSBASIC_INPUT_SIGNAL: recupera il formato del segnale che il dv è progettato per accettare. Restituisce una delle costanti seguenti in pValue.

  Costante	Descrizione
  ED_TRANSBASIC_SIGNAL_525_60_SD	Segnale NTSC SD.
  ED_TRANSBASIC_SIGNAL_525_60_SDL	Segnale NTSC SDL (long-play).
  ED_TRANSBASIC_SIGNAL_625_50_SD	Segnale PAL SD.
  ED_TRANSBASIC_SIGNAL_625_50_SDL	Segnale PAL SDL (long-play).
  ED_TRANSBASIC_SIGNAL_MPEG2TS	Segnale D-VHS.

   
• ED_TRANSBASIC_OUTPUT_SIGNAL: recupera il formato del segnale che il DV è progettato per trasmettere. Restituisce una delle costanti elencate per il flag ED_TRANSBASIC_INPUT_SIGNAL.

MSTape supporta valori aggiuntivi per ED_TRANSBASIC_INPUT_SIGNAL e ED_TRANSBASIC_OUTPUT_SIGNAL.

Questi flag sono definiti nel file di intestazione Xprtdefs.h.

In Windows XP Service Pack 2 e versioni successive vengono definiti i seguenti tipi di segnale aggiuntivi per i flag ED_TRANSBASIC_INPUT_SIGNAL e ED_TRANSBASIC_OUTPUT_SIGNAL.

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

Requisiti

Vedi anche

Codici errore e esito positivo

Interfaccia IAMExtTransport