IAMExtDevice::Calibrate-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 Calibrate -Methode kalibriert den Transportmechanismus eines externen Geräts.

Diese Methode ist nicht implementiert.

Syntax

HRESULT Calibrate(
  [in]  HEVENT hEvent,
  [in]  long   Mode,
  [out] long   *pStatus
);

Parameter

[in] hEvent

Handle für ein Ereignis. Das Ereignis wird signalisiert, wenn die Aktion abgeschlossen ist.

[in] Mode

Gibt einen Wert an, der den Kalibrierungsprozess aktiviert oder deaktiviert:

Wert	BESCHREIBUNG
ED_ACTIVE	Aktiviert den Kalibrierungsprozess.
ED_INACTIVE	Deaktiviert den Kalibrierungsprozess.
NULL	Keine Aktion; gibt die status Kalibrierung in pStatus zurück.

[out] pStatus

Zeiger auf eine lange ganze Zahl, die einen der folgenden Werte empfängt:

Wert	BESCHREIBUNG
OATRUE	Die Kalibrierung ist aktiv.
OAFALSE	Die Kalibrierung ist inaktiv.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Hinweise

Verwenden Sie diese Methode auf bestimmten externen Geräten, die eine Kalibrierung erfordern. Beispiel: Zurückspulen eines Bandes und Zurücksetzen des Zählers oder Berechnen des Frameoffsets für einen Timecodeleser.

Filter für verschiedene externe Geräte können diese Methode je nach Kalibrierung, die das Gerät benötigt, unterschiedlich implementieren. Bei dieser Methode wird davon ausgegangen, dass die IMediaEventSink-Schnittstelle bereits eine Ereignissenke eingerichtet hat oder dass eine andere Ereignissignalisierungsmethode eingerichtet wurde.

DV-Implementierung

Die MSDV - und UVC-Treiber unterstützen diese Methode nicht. Die -Methode gibt E_NOTIMPL zurück.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	strmif.h (include Dshow.h)
Bibliothek	Strmiids.lib

Weitere Informationen

Fehler- und Erfolgscodes

IAMExtDevice-Schnittstelle