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 |