Metodo IVideoFrameStep::Step (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 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 |
|---|---|
|
Operazione completata. |
|
L'esecuzione dei fotogrammi non è supportata. |
|
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 |