Metodo IVideoFrameStep::Step (strmif.h)

  • Articolo

[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 Step metodo fa sì che il grafico del filtro passi avanti in base al numero specificato di fotogrammi.

Sintassi

HRESULT Step(
  DWORD    dwFrames,
  IUnknown *pStepObject
);

Parametri

dwFrames

Specifica il numero di fotogrammi da ignorare. Se dwFrames è 1, il grafico avanza in avanti di un fotogramma. Se dwFrames è un numero n maggiore di 1, il grafico ignora n - 1 fotogrammi e mostra il nfotogramma.

pStepObject

Puntatore a un'interfaccia sul filtro che controlla l'operazione di esecuzione o NULL. Specificare NULL per eseguire l'istruzione dei fotogrammi usando il filtro del renderer nel grafico. Se non è NULL, l'oggetto deve implementare l'interfaccia IKsPropertySet e supportare la proprietà AM_KSPROPSETID_FrameStep. Per altre informazioni, vedere Set di proprietà Istruzione frame. Se il grafico include un filtro personalizzato che implementa l'istruzione dei fotogrammi, pStepObject può specificare un puntatore a tale filtro.

Valore restituito

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

Codice restituito Descrizione
S_OK
 Operazione completata.
VFW_E_FRAME_STEP_UNSUPPORTED
 L'esecuzione dei fotogrammi non è supportata.
E_INVALIDARG
 Il parametro pStepObject non è valido.

Commenti

Al termine dell'operazione di passaggio, questo metodo invia una notifica di evento EC_STEP_COMPLETE al gestore del grafo dei filtri, che lo passerà al ciclo di eventi dell'applicazione e imposterà il grafico del filtro su uno stato sospeso.

Il passaggio dei fotogrammi in tempo reale, il che significa che se il film viene riprodotto a 30 fotogrammi al secondo, la chiamata a IVideoFrameStep::Step con dwFrames impostato su 60 richiederebbe 2 secondi per l'esecuzione. Tutti i metodi in questa interfaccia sono asincroni, quindi il controllo torna immediatamente all'applicazione.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [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 IVideoFrameStep