IAMExtDevice::GetCapability-Methode (strmif.h)
[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.]
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 unter Hinweise.
[out] pValue
Zeiger auf eine Variable, die eine lange ganze Zahl empfängt. Weitere Informationen finden Sie unter Hinweise.
[out] pdblValue
Zeiger auf eine Variable, die ein Double empfängt. Weitere Informationen finden Sie unter Hinweise.
Rückgabewert
Wenn diese Methode erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.
Hinweise
Der Capability-Parameter ist ein Flag, das angibt, welche Funktion überprüft werden soll. Die Methode gibt das Ergebnis entweder im pValue-Parameter oder im pdblValue-Parameter zurück, abhängig vom Funktionsflag.
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.
| Funktionsflag | 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 eingabe, die derzeit ausgewählt ist. |
| ED_DEVCAP_CAN_PREVIEW | Das Gerät kann eine Vorschau anzeigen. |
| ED_DEVCAP_CAN_RECORD | Das Gerät kann aufzeichnen. |
| ED_DEVCAP_CAN_RECORD_STROBE | Das Gerät kann Stroboskopdaten aufzeichnen. Diese Funktion gilt für Mehrspurgeräte, die auf ausgewählte Spuren aufzeichnen können. |
| ED_DEVCAP_CAN_SAVE | Das Gerät kann Daten speichern. |
| ED_DEVCAP_CTLTRK_READ | Das Gerät kann Steuerungsspuren 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::Calibrate. |
| ED_DEVCAP_TIMECODE_READ | Das Gerät kann SMPTE-Zeitcode lesen. |
| ED_DEVCAP_TIMECODE_WRITE | Das Gerät kann den 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 | Audiobandrecorder |
| ED_DEVTYPE_CG | Zeichengenerator |
| ED_DEVTYPE_DDR | Digitaler Datenträgerrekorder |
| ED_DEVTYPE_DVE | Einheit für digitale Videoeffekte |
| ED_DEVTYPE_GPI | Universeller Schnittstellentrigger |
| ED_DEVTYPE_KEYER | Videotaster |
| ED_DEVTYPE_LASERDISK | Laserdisc |
| ED_DEVTYPE_MIXER_AUDIO | Audiomischer |
| ED_DEVTYPE_MIXER_VIDEO | Videomischer |
| ED_DEVTYPE_ROUTER | Videorouter |
| ED_DEVTYPE_TBC | Timebase Corrector |
| ED_DEVTYPE_TCG | Timecodegenerator/-reader |
| ED_DEVTYPE_VCR | Videorekorder 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 hat eine genaue Genauigkeit. |
| ED_SYNCACC_FRAME | Das Gerät ist framegenau. |
| ED_SYNCACC_ROUGH | Das Gerät ist weniger als framegenau. |
ED_DEVCAP_NORMAL_RATE: Gibt die normale Bildfrequenz 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 suchen, ohne dass ein Signal unterbrochen wird. |
| ED_SEEK_FAST | Das Gerät kann schnell suchen, mit einer kurzen Pause im Signal. |
| ED_SEEK_SLOW | Das Gerät sucht langsam; z. B. Bandtransport. |
Für die folgenden Flags gibt die Methode einen numerischen Wert im pValue-Parameter zurück.
| Funktionsflag | Rückgabewert |
| ED_DEVCAP_EXTERNAL_DEVICE_ID | Herstellerspezifischer Bezeichner. |
| ED_DEVCAP_PREROLL | Vorrollzeit des Geräts. |
| ED_DEVCAP_POSTROLL | Nachbearbeitungszeit des Geräts. |
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 Standbilder 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 die folgenden Verhaltensweisen.Das flag ED_DEVCAP_NORMAL_RATE gibt die Bildfrequenz zurück.
| Zurückgegebene Konstante | BESCHREIBUNG |
|---|---|
| ED_RATE_25 | 25 fps (Standardmäßige PAL-Bildfrequenz) |
| ED_RATE_2997 | 29,997 fps (Standard-NTSC-Bildfrequenz) |
Nur für MSDV gibt das flag ED_DEVCAP_DEVICE_TYPE 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, aber keine vollständigen Videorekorderfunktionen bietet. |
| 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 |
|---|---|
| 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 |