Metodo IMFSeekInfo::GetNearestKeyFrames (mfidl.h)
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 |
---|---|
|
Il metodo è riuscito. |
|
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 |