Metodo IMFSourceReader::SetCurrentPosition (mfreadwrite.h)

Articolo
02/28/2024

Cerca una nuova posizione nell'origine multimediale.

Sintassi

HRESULT SetCurrentPosition(
  [in] REFGUID        guidTimeFormat,
  [in] REFPROPVARIANT varPosition
);

Parametri

[in] guidTimeFormat

GUID che specifica il formato dell'ora. Il formato dell'ora definisce le unità per il parametro varPosition . Per tutte le origini multimediali viene definito il valore seguente:

Valore	Significato
GUID_NULL	Unità da 100 nanosecondi.

Alcune origini multimediali potrebbero supportare valori aggiuntivi.

[in] varPosition

Posizione da cui verrà avviata la riproduzione. Le unità vengono specificate dal parametro guidTimeFormat . Se il parametro guidTimeFormat è GUID_NULL, impostare il tipo variant su VT_I8.

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_INVALIDREQUEST	Una o più richieste di esempio sono ancora in sospeso.

Commenti

Il metodo SetCurrentPosition non garantisce la ricerca esatta. L'accuratezza della ricerca dipende dal contenuto multimediale. Se il contenuto multimediale contiene un flusso video, il metodo SetCurrentPosition cerca in genere il fotogramma chiave più vicino prima della posizione desiderata. La distanza tra fotogrammi chiave dipende da diversi fattori, tra cui l'implementazione del codificatore, il contenuto video e le impostazioni di codifica specifiche usate per codificare il contenuto. La distanza tra fotogrammi chiave può variare all'interno di un singolo file video (ad esempio, a seconda della complessità della scena).

Dopo la ricerca, l'applicazione deve chiamare IMFSourceReader::ReadSample e passare alla posizione desiderata.

Questa interfaccia è 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

Vedi anche

IMFSourceReader

Lettore di origine

Condividi tramite