Metodo IMFSinkWriter::P laceMarker (mfreadwrite.h)

Articolo
02/28/2024

Places un marcatore nel flusso specificato.

Sintassi

HRESULT PlaceMarker(
  [in] DWORD  dwStreamIndex,
  [in] LPVOID pvContext
);

Parametri

[in] dwStreamIndex

Indice in base zero del flusso.

[in] pvContext

Puntatore a un valore definito dall'applicazione. Il valore di questo parametro viene restituito al chiamante nel parametro pvContext del chiamante FMSinkWriterCallback::OnMarker callback. L'applicazione è responsabile di qualsiasi allocazione di memoria associata a questi dati. Questo parametro può essere NULL.

Valore restituito

Il metodo restituisce un 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_INVALIDREQUEST	La richiesta non è valida.

Commenti

Per usare questo metodo, è necessario fornire un callback asincrono quando si crea il writer sink. In caso contrario, il metodo restituisce MF_E_INVALIDREQUEST. Per altre informazioni, vedere MF_SINK_WRITER_ASYNC_CALLBACK.

I marcatori consentono di ricevere una notifica quando il sink multimediale usa tutti gli esempi in un flusso fino a un determinato punto. Il sink multimediale non elabora il marcatore finché non viene elaborato tutti gli esempi che sono venuti prima del marcatore. Quando il sink multimediale elabora il marcatore, il writer sink chiama il metodo OnMarker dell'applicazione. Quando viene richiamato il callback, si sa che il sink ha usato tutti gli esempi precedenti per tale flusso.

Ad esempio, per modificare il formato midstream, chiamare PlaceMarker nel punto in cui il formato cambia. Quando Viene chiamato OnMarker , è possibile chiamare FMSinkWriter::SetInputMediaType per modificare il tipo di input (presupponendo che il sink multimediale supporti le modifiche al formato dinamico).

Internamente, questo metodo chiama FMStreamSink::P laceMarker nel sink multimediale.

Nota Il parametro pvContext del metodo IMFSinkWriter::P laceMarker non viene passato al parametro pvarContextValue del metodo FMStreamSink ::P laceMarker . Questi due parametri non sono direttamente correlati.

Questa interfaccia è disponibile in Windows Vista se è installato l'aggiornamento della piattaforma per Windows Vista.

Requisiti

Requisito	Valore
Client minimo supportato	Supplemento per Windows 7, Windows Vista e Aggiornamento 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

Vedi anche

FMSinkWriter

Sink Writer

Share via