Funzione MFCreateSourceReaderFromMediaSource (mfreadwrite.h)

Articolo
03/05/2024

Crea il lettore di origine da un'origine multimediale.

Sintassi

HRESULT MFCreateSourceReaderFromMediaSource(
  [in]  IMFMediaSource  *pMediaSource,
  [in]  IMFAttributes   *pAttributes,
  [out] IMFSourceReader **ppSourceReader
);

Parametri

[in] pMediaSource

Puntatore all'interfaccia IMFMediaSource di un'origine multimediale.

[in] pAttributes

Puntatore all'interfaccia IMFAttributes . È possibile usare questo parametro per configurare il lettore di origine. Per altre informazioni, vedere Attributi del lettore di origine. Questo parametro può essere NULL.

[out] ppSourceReader

Riceve un puntatore all'interfaccia IMFSourceReader . Il chiamante deve rilasciare l'interfaccia.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
MF_E_DRM_UNSUPPORTED	L'origine contiene contenuto protetto.

Commenti

Chiama CoInitialize(Ex) e MFStartup prima di chiamare questa funzione.

Per impostazione predefinita, quando l'applicazione rilascia il lettore di origine, il lettore di origine arresta l'origine multimediale chiamando IMFMediaSource::Shutdown nell'origine multimediale. A questo punto, l'applicazione non può più usare l'origine multimediale.

Per modificare questo comportamento predefinito, impostare l'attributo MF_SOURCE_READER_DISCONNECT_MEDIASOURCE_ON_SHUTDOWN nel parametro pAttributes . Se questo attributo è TRUE, l'applicazione è responsabile dell'arresto dell'origine multimediale.

Quando si usa il lettore di origine, non chiamare uno dei metodi seguenti nell'origine multimediale:

Questa funzione è disponibile in Windows Vista se è installato Platform Update Supplement per Windows Vista.

Requisiti

Requisito	Valore
Client minimo supportato	Supplemento per Windows 7, Windows Vista e Aggiornamento della piattaforma per Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	mfreadwrite.h
Libreria	Mfreadwrite.lib
DLL	Mfreadwrite.dll

Vedi anche

Funzioni di Media Foundation

Lettore di origine

Condividi tramite