ICaptureGraphBuilder::ControlStream-Methode (strmif.h)

Artikel
07/28/2023

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Hinweis Die ICaptureGraphBuilder-Schnittstelle ist veraltet. Verwenden Sie stattdessen ICaptureGraphBuilder2 .

Sendet Streamsteuerungsmeldungen an den Pin der angegebenen Kategorie für einen oder mehrere Erfassungsfilter in einem Diagramm.

Syntax

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

Parameter

[in] pCategory

Zeiger auf eine GUID , die die Ausgabeheftkategorie angibt. Eine Liste aller Anheftungskategorien finden Sie unter Anheftungseigenschaftensatz . Dieser Wert darf nicht NULL sein.

[in] pFilter

Zeiger auf eine IBaseFilter-Schnittstelle im zu steuernden Filter. Die Angabe von NULL steuert alle Erfassungsfilter im Diagramm. Sie erhalten eine Benachrichtigung für jeden Erfassungsfilter.

[in] pstart

Zeiger auf den Startzeitpunkt für die Erfassung. NULL bedeutet jetzt starten. MAX_TIME bedeutet, vorherige Anforderung abzubrechen oder keine Aktion zu ergreifen, wenn keine vorherige Anforderung vorhanden ist.

[in] pstop

Zeiger auf die Stoppzeit für die Erfassung. NULL bedeutet jetzt beenden. MAX_TIME bedeutet, vorherige Anforderung abzubrechen oder keine Aktion zu ergreifen, wenn keine vorherige Anforderung vorhanden ist.

[in] wStartCookie

Gibt einen bestimmten Wert an, der beim Start gesendet werden soll.

[in] wStopCookie

Gibt einen bestimmten Wert an, der gesendet werden soll, wenn der Stopp auftritt.

Rückgabewert

Gibt S_FALSE zurück, wenn die Stoppbenachrichtigung gesendet wird, bevor das letzte vom Erfassungsfilter gesendete Beispiel gerendert wird, andernfalls S_OK zurück.

Wenn diese Methode S_FALSE zurückgibt, möchte die Anwendung möglicherweise warten, bevor sie das Filterdiagramm beendet, damit alle Beispiele das Diagramm durchlaufen und gerendert werden können. Andernfalls können Beispiele verlorengehen.

Wenn keine Pins vorhanden sind, die der von Ihnen angegebenen Beschreibung entsprechen, oder wenn das Streamsteuerelement nicht für alle angegebenen Pins unterstützt werden kann, gibt diese Funktion einen Fehlercode zurück.

Bemerkungen

Verwenden Sie diese Methode für die framegenaue Erfassung oder für die individuelle Steuerung von Erfassung und Vorschau. Beispielsweise können Sie das Schreiben des erfassten Images auf den Datenträger deaktivieren, wenn Sie nur eine Vorschau des erfassten Images anzeigen möchten.

Diese Methode verwendet die IAMStreamControl-Schnittstelle für die Pins.

Diese Methode sendet eine Benachrichtigung für jeden gefundenen Filter mit einem Pin der angegebenen Kategorie.

Requirements (Anforderungen)


Zielplattform	Windows
Kopfzeile	strmif.h (include Dshow.h)

Siehe auch

Fehler- und Erfolgscodes

ICaptureGraphBuilder-Schnittstelle

Freigeben über