Metodo IAMVideoCompression::OverrideKeyFrame (strmif.h)

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il OverrideKeyFrame metodo indica al filtro di comprimere un frame specifico come fotogramma chiave.

Sintassi

HRESULT OverrideKeyFrame(
  [in] long FrameNumber
);

Parametri

[in] FrameNumber

Specifica il numero di fotogramma. Il primo frame recapitato dal filtro è numerato zero.

Valore restituito

Restituisce un valore HRESULT . Di seguito sono indicati alcuni valori possibili.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_NOTIMPL	Non implementato.

Commenti

Se il filtro supporta questo metodo, è possibile usarlo per eseguire l'override della normale distribuzione dei fotogrammi chiave per un determinato frame. Dopo aver creato un fotogramma chiave, il filtro potrebbe reimpostarne il conteggio per determinare quando deve verificarsi il fotogramma chiave successivo. Ad esempio, se la frequenza dei fotogrammi chiave è 10 e un'applicazione usa questo metodo per forzare il fotogramma 5 come fotogramma chiave, il filtro potrebbe attendere altri 10 fotogrammi (fino a frame 15) prima di creare il fotogramma chiave successivo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	strmif.h (include Dshow.h)
Libreria	Strmiids.lib

Vedi anche

Codici di errore e di esito positivo

Interfaccia IAMVideoCompression