Freigeben über


IAMVfwCaptureDialogs::SendDriverMessage-Methode (strmif.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die SendDriverMessage -Methode sendet eine treiberspezifische Nachricht.

Syntax

HRESULT SendDriverMessage(
  [in] int  iDialog,
  [in] int  uMsg,
  [in] long dw1,
  [in] long dw2
);

Parameter

[in] iDialog

Handle des Treiberdialogfelds. Dies ist ein Mitglied der VfwCaptureDialogs-Enumeration .

[in] uMsg

Nachricht, die an den Treiber gesendet werden soll.

[in] dw1

Nachrichtendaten.

[in] dw2

Nachrichtendaten.

Rückgabewert

Der Rückgabewert variiert je nach Implementierung innerhalb der einzelnen Treiber.

Hinweise

Sie sollten diese Methode niemals verwenden müssen. Diese Methode kann jede private Nachricht an den Erfassungstreiber senden. Das Verhalten kann als Reaktion auf beliebige Nachrichten unbestimmt sein. Verwenden Sie diese Methode auf eigenes Risiko.

Diese Methode ruft die videoMessage-Funktion Video für Windows auf, um die Treibernachricht zu senden.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile strmif.h (include Dshow.h)
Bibliothek Strmiids.lib

Weitere Informationen

Fehler- und Erfolgscodes

IAMVfwCaptureDialogs-Schnittstelle