IAMExtDevice::GetCapability-Methode (strmif.h)
[Das dieser Seite zugeordnete Feature DirectShow-ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngineund Audio/Video Capture in Media Foundationersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code MediaPlayer-, IMFMediaEngine und Audio-/Videoaufnahme in Media Foundation anstelle von DirectShow-verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, um die neuen APIs zu verwenden, falls möglich umgeschrieben werden.]
Die GetCapability-Methode ruft die Funktionen des externen Geräts ab.
Syntax
HRESULT GetCapability(
[in] long Capability,
[out] long *pValue,
[out] double *pdblValue
);
Parameter
[in] Capability
Gibt die zu überprüfende Funktion an. Weitere Informationen finden Sie in den Hinweisen.
[out] pValue
Zeiger auf eine Variable, die eine langen ganze Zahl empfängt. Weitere Informationen finden Sie in den Hinweisen.
[out] pdblValue
Zeiger auf eine Variable, die eine doubleempfängt. Weitere Informationen finden Sie in den Hinweisen.
Rückgabewert
Wenn diese Methode erfolgreich verläuft, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT- Fehlercode zurückgegeben.
Bemerkungen
Der parameter Capability ist ein Flag, das angibt, welche Funktion überprüft werden soll. Die Methode gibt das Ergebnis entweder im parameter pValue oder im pdblValue Parameter zurück, je nach Funktionskennzeichnung.
Für die folgenden Flags gibt die Methode den Wert OATRUE oder OAFALSE im pValue Parameter zurück. Der Wert OATRUE gibt an, dass die Funktion vorhanden ist, während der Wert OAFALSE angibt, dass sie nicht vorhanden ist.
| Funktionskennzeichnung | Beschreibung |
|---|---|
| ED_DEVCAP_AUDIO_INPUTS | Das Gerät akzeptiert Audioeingaben. |
| ED_DEVCAP_CAN_MONITOR_SOURCES | Das Gerät kann jede Eingabe an die überwachte Ausgabe senden, unabhängig von der aktuell ausgewählten Eingabe. |
| ED_DEVCAP_CAN_PREVIEW | Das Gerät kann eine Vorschau anzeigen. |
| ED_DEVCAP_CAN_RECORD | Gerät kann aufzeichnen. |
| ED_DEVCAP_CAN_RECORD_STROBE | Gerät kann Strobedatensatz aufzeichnen. Diese Funktion gilt für Multitrack-Geräte, die auf ausgewählten Titeln aufzeichnen können. |
| ED_DEVCAP_CAN_SAVE | Das Gerät kann Daten speichern. |
| ED_DEVCAP_CTLTRK_READ | Das Gerät kann Steuertitel lesen. |
| ED_DEVCAP_HAS_AUDIO | Das Gerät verfügt über Audio. |
| ED_DEVCAP_HAS_VIDEO | Das Gerät verfügt über Video. |
| ED_DEVCAP_INDEX_READ | Das Gerät kann Indexmarken lesen. |
| ED_DEVCAP_NEEDS_CALIBRATING | Das Gerät muss kalibriert werden. Siehe IAMExtDevice::Kalibrieren. |
| ED_DEVCAP_TIMECODE_READ | Das Gerät kann SMPTE-Zeitcode lesen. |
| ED_DEVCAP_TIMECODE_WRITE | Das Gerät kann SMPTE-Zeitcode festlegen. |
| ED_DEVCAP_USES_FILES | Das Gerät verfügt über ein integriertes Dateisystem. |
| ED_DEVCAP_VIDEO_INPUTS | Das Gerät akzeptiert Videoeingaben. |
Für die folgenden Flags gibt die Methode eine definierte Konstante im pValue Parameter zurück.
ED_DEVCAP_DEVICE_TYPE: Gibt den Gerätetyp zurück.
| Zurückgegebene Konstante | Beschreibung |
|---|---|
| ED_DEVTYPE_ATR | Audiobandrekorder |
| ED_DEVTYPE_CG | Zeichengenerator |
| ED_DEVTYPE_DDR | Digitaler Datenträgerrekorder |
| ED_DEVTYPE_DVE | Einheit für digitale Videoeffekte |
| ED_DEVTYPE_GPI | Allgemeiner Schnittstellentrigger |
| ED_DEVTYPE_KEYER | Videotaster |
| ED_DEVTYPE_LASERDISK | Laserdisc |
| ED_DEVTYPE_MIXER_AUDIO | Audiomixer |
| ED_DEVTYPE_MIXER_VIDEO | Videomischer |
| ED_DEVTYPE_ROUTER | Videorouter |
| ED_DEVTYPE_TBC | Zeitbasiskorrektur |
| ED_DEVTYPE_TCG | Timecode-Generator/Reader |
| ED_DEVTYPE_VCR | VCR oder Camcorder mit vollständigen VCR-Funktionen |
| ED_DEVTYPE_WIPEGEN | Videozurücksetzungsgenerator |
| ED_DEVTYPE_JOYSTICK | Joystick |
| ED_DEVTYPE_KEYBOARD | Tastatur |
ED_DEVCAP_SYNC_ACCURACY: Gibt einen Hinweis auf die Synchronisierungsgenauigkeit des Geräts zurück.
| Zurückgegebene Konstante | Beschreibung |
|---|---|
| ED_SYNCACC_PRECISE | Das Gerät verfügt über präzise Genauigkeit. |
| ED_SYNCACC_FRAME | Das Gerät ist framegenau. |
| ED_SYNCACC_ROUGH | Das Gerät ist kleiner als framegenau. |
ED_DEVCAP_NORMAL_RATE: Gibt die normale Framerate des Geräts zurück.
| Zurückgegebene Konstante | Beschreibung |
|---|---|
| ED_RATE_24 | 24 Frames pro Sekunde (fps) |
| ED_RATE_25 | 25 fps |
| ED_RATE_2997 | 29,97 fps |
| ED_RATE_30 | 30 fps |
ED_DEVCAP_SEEK_TYPE: Gibt einen Hinweis auf die Suchgenauigkeit des Geräts zurück.
| Zurückgegebene Konstante | Beschreibung |
|---|---|
| ED_SEEK_PERFECT | Das Gerät kann innerhalb eines Videoframes ohne Signalunterbrechung suchen. |
| ED_SEEK_FAST | Das Gerät kann schnell suchen, mit einem kurzen Bruch im Signal. |
| ED_SEEK_SLOW | Gerät sucht langsam; wie Bandtransport. |
Für die folgenden Flags gibt die Methode einen numerischen Wert im pValue--Parameter zurück.
| Funktionskennzeichnung | Zurückgegebener Wert |
| ED_DEVCAP_EXTERNAL_DEVICE_ID | Herstellerspezifischer Bezeichner. |
| ED_DEVCAP_PREROLL | Gerätevorrollzeit. |
| ED_DEVCAP_POSTROLL | Geräte-Postrollzeit. |
In Windows XP Service Pack 2 und höher werden die folgenden zusätzlichen Flags für ED_DEVCAP_DEVICE_TYPE unterstützt.
| Zurückgegebene Konstante | Beschreibung |
|---|---|
| ED_DEVTYPE_CAMERA_STORAGE | Speicher für stille Bilder oder kurze Videodateien. |
| ED_DEVTYPE_DTV | Digitales Fernsehen mit serieller Busschnittstelle. |
| ED_DEVTYPE_PC_VIRTUAL | Virtuelles oder emuliertes Gerät auf einem Computer. |
Um diese Konstanten zu verwenden, schließen Sie die Headerdatei Xprtdefs.h ein.
DV-Implementierung
Die MSDV- und UVC-Treiber unterstützen das folgende Verhalten.Das ED_DEVCAP_NORMAL_RATE Flag gibt die Framerate zurück.
| Zurückgegebene Konstante | Beschreibung |
|---|---|
| ED_RATE_25 | 25 fps (Standard-PAL-Bildfrequenz) |
| ED_RATE_2997 | 29,997 fps (Standard-NTSC-Framerate) |
Nur für MSDV gibt das ED_DEVCAP_DEVICE_TYPE Flag den Gerätetyp zurück. Mögliche Werte werden in der folgenden Tabelle angezeigt. Verwenden Sie für UVC-Geräte stattdessen die IKsTopologyInfo Schnittstelle.
| Zurückgegebene Konstante | Beschreibung |
|---|---|
| ED_DEVTYPE_CAMERA | Einfache Kamera, die Aufzeichnungen oder Pausenaufzeichnungen ausführen kann, verfügt jedoch nicht über vollständige VCR-Funktionen. |
| ED_DEVTYPE_DVHS | Das Gerät unterstützt das D-VHS-Format. |
| ED_DEVTYPE_UNKNOWN | Unbekannter Gerätetyp. |
| ED_DEVTYPE_VCR | Das Gerät verfügt über vollständige VCR-Funktionen. |
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | strmif.h (include Dshow.h) |
| Library | Strmiids.lib |