Metodo IMFSourceReader::SetCurrentPosition (mfreadwrite.h)

  • Articolo

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