Metodo CBasePin.ConnectionMediaType

  • 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 metodo ConnectionMediaType recupera il tipo di supporto per la connessione pin corrente, se presente. Questo metodo implementa il metodo IPin::ConnectionMediaType .

Sintassi

HRESULT ConnectionMediaType(
   AM_MEDIA_TYPE *pmt
);

Parametri

Pmt

Puntatore a una struttura AM_MEDIA_TYPE che riceve il tipo di supporto.

Valore restituito

Restituisce un valore HRESULT . I valori possibili includono quelli nella tabella seguente.

Codice restituito Descrizione
S_OK
 Operazione completata.
E_POINTER
 Argomento puntatore NULL.
VFW_E_NOT_CONNECTED
 Il pin non è connesso.

Commenti

Se il pin è connesso, questo metodo copia il tipo di supporto nella struttura AM_MEDIA_TYPE specificata da pmt. Il chiamante deve liberare il blocco di formato del tipo di supporto. È possibile usare la funzione CoTaskMemFree o la funzione helper FreeMediaType .

Se il pin non è connesso, questo metodo zerozza il blocco di memoria specificato da pmt e restituisce un codice di errore.

Requisiti

Requisito Valore
Intestazione
Amfilter.h (include Streams.h)
Libreria
Strmbase.lib (build al dettaglio);
Strmbasd.lib (build di debug)

Vedi anche

Classe CBasePin