Metodo IMFSeekInfo::GetNearestKeyFrames (mfidl.h)

  • Articolo

Per una determinata posizione di ricerca, ottiene i due fotogrammi chiave più vicini.

Sintassi

HRESULT GetNearestKeyFrames(
  [in]  const GUID        *pguidTimeFormat,
  [in]  const PROPVARIANT *pvarStartPosition,
  [out] PROPVARIANT       *pvarPreviousKeyFrame,
  [out] PROPVARIANT       *pvarNextKeyFrame
);

Parametri

[in] pguidTimeFormat

Puntatore a un GUID che specifica il formato ora. Il formato ora definisce le unità per gli altri parametri di questo metodo. Se il valore è GUID_NULL, il formato ora è 100-nanosecondi. Alcune origini multimediali potrebbero supportare GUID di formato aggiuntivo.

[in] pvarStartPosition

Posizione di ricerca. Le unità per questo parametro vengono specificate da pguidTimeFormat.

[out] pvarPreviousKeyFrame

Riceve la posizione del fotogramma chiave più vicino visualizzato in precedenza rispetto a pvarStartPosition. Le unità per questo parametro vengono specificate da pguidTimeFormat.

[out] pvarNextKeyFrame

Riceve la posizione del fotogramma chiave più vicino visualizzato in seguito a pvarStartPosition. Le unità per questo parametro vengono specificate da pguidTimeFormat.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito Descrizione
S_OK
 Il metodo è riuscito.
MF_E_UNSUPPORTED_TIME_FORMAT
 Il formato ora specificato in pguidTimeFormat non è supportato.

Commenti

Se un'applicazione cerca un frame non chiave, il decodificatore deve avviare la decodificazione dal fotogramma chiave precedente. Ciò può aumentare la latenza, perché diversi fotogrammi potrebbero essere decodificati prima che venga raggiunto il frame richiesto. Per ridurre la latenza, un'applicazione può chiamare questo metodo per trovare i due fotogrammi chiave più vicini al tempo desiderato e quindi cercare uno di questi fotogrammi chiave.

Requisiti

   
Client minimo supportato Windows 8 [solo app desktop]
Server minimo supportato Windows Server 2012 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione mfidl.h

Vedi anche

FMISeekInfo