Metodo ICaptureGraphBuilder::ControlStream (strmif.h)

Articolo
07/28/2023

[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.

Nota L'interfaccia ICaptureGraphBuilder è deprecata. Usare invece ICaptureGraphBuilder2 .

Invia messaggi di controllo del flusso al pin della categoria specificata in uno o più filtri di acquisizione in un grafico.

Sintassi

HRESULT ControlStream(
  [in] const GUID     *pCategory,
  [in] IBaseFilter    *pFilter,
  [in] REFERENCE_TIME *pstart,
  [in] REFERENCE_TIME *pstop,
  [in] WORD           wStartCookie,
  [in] WORD           wStopCookie
);

Parametri

[in] pCategory

Puntatore a un GUID che specifica la categoria del pin di output. Per un elenco di tutte le categorie di pin, vedere Pin Property Set .See Pin Property Set for a list of all pin categories. Questo valore non può essere NULL.

[in] pFilter

Puntatore a un'interfaccia IBaseFilter nel filtro da controllare. Specificando i controlli NULL , tutti i filtri di acquisizione nel grafico. Si riceverà una notifica per ogni filtro di acquisizione.

[in] pstart

Puntatore all'ora di inizio per l'acquisizione. NULL significa iniziare ora. MAX_TIME significa annullare la richiesta precedente o non eseguire alcuna azione se non è presente alcuna richiesta precedente.

[in] pstop

Puntatore al tempo di arresto per l'acquisizione. NULL significa arrestare ora. MAX_TIME significa annullare la richiesta precedente o non eseguire alcuna azione se non è presente alcuna richiesta precedente.

[in] wStartCookie

Specifica un particolare valore da inviare quando si verifica l'avvio.

[in] wStopCookie

Specifica un valore specifico da inviare quando si verifica l'arresto.

Valore restituito

Restituisce S_FALSE se la notifica di arresto viene inviata prima del rendering dell'ultimo esempio inviato dal filtro di acquisizione, in caso contrario restituisce S_OK.

Se questo metodo restituisce S_FALSE, l'applicazione potrebbe voler attendere prima di arrestare il grafico del filtro per consentire a tutti i campioni di passare il grafico ed eseguire il rendering. In caso contrario, è possibile che gli esempi vadano persi.

Se non sono presenti pin corrispondenti alla descrizione specificata o se il controllo flusso non può essere supportato in tutti i pin indicati, questa funzione restituirà un codice di errore.

Commenti

Usare questo metodo per l'acquisizione accurata dei fotogrammi o per il controllo individuale dell'acquisizione e dell'anteprima. Ad esempio, è possibile disattivare la scrittura dell'immagine acquisita su disco se si vuole solo visualizzare in anteprima l'immagine acquisita.

Questo metodo usa l'interfaccia IAMStreamControl sui pin.

Questo metodo invia una notifica per ogni filtro trovato con un pin della categoria specificata.

Requisiti


Piattaforma di destinazione	Windows
Intestazione	strmif.h (include Dshow.h)

Vedi anche

Codici di errore e di esito positivo

Interfaccia ICaptureGraphBuilder

Condividi tramite