IAMExtTransport::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 allgemeinen Funktionen des Transports 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.
| Funktionsflagge | BESCHREIBUNG |
|---|---|
| ED_TRANSCAP_CAN_ASSEMBLE | Der Transport kann den Assemble Record-Modus verwenden (neue Spuren aufzeichnen, die nahtlos mit der Steuerungsspur aus dem zuvor aufgezeichneten Segment verknüpft sind). |
| ED_TRANSCAP_CAN_BUMP_PLAY | Der Transport kann mit unterschiedlicher Geschwindigkeit synchronisiert werden. |
| ED_TRANSCAP_CAN_DELAY_AUDIO_IN | Der Transport kann verzögerte Audiobearbeitungen ausführen. |
| ED_TRANSCAP_CAN_DELAY_AUDIO_OUT | Der Transport kann verzögerte Audiobearbeitungen ausführen. |
| ED_TRANSCAP_CAN_DELAY_VIDEO_IN | Der Transport kann verzögerte Videobearbeitungen ausführen. |
| ED_TRANSCAP_CAN_DELAY_VIDEO_OUT | Der Transport kann verzögerte Videobearbeitungen ausführen. |
| ED_TRANSCAP_CAN_DETECT_LENGTH | Transport kann die Länge der Medien erkennen. |
| ED_TRANSCAP_CAN_EJECT | Der Transport kann das Medium auswerfen. |
| ED_TRANSCAP_CAN_FREEZE | Der Transport kann einfrieren/anhalten. |
| ED_TRANSCAP_CAN_INSERT | Transport kann den Datensatzeinfügemodus verwenden (einzelne Spuren aufzeichnen, während sie für eine vorab aufgezeichnete Steuerungsspur gesperrt sind). |
| ED_TRANSCAP_CAN_PLAY_BACKWARDS | Transport kann rückwärts wiedergegeben werden. |
| ED_TRANSCAP_CAN_SET_EE | Transport kann die Eingabe des Geräts in der Ausgabe anzeigen. |
| ED_TRANSCAP_CAN_SET_PB | Der Transport kann die Medienwiedergabe in der Ausgabe anzeigen. |
| ED_TRANSCAP_FIELD_STEP | Der Transport reagiert auf einen Frame advance-Befehl, indem er ein Feld vorantreibt. |
| ED_TRANSCAP_HAS_CLOCK | Das Gerät verfügt über eine Uhr. |
| ED_TRANSCAP_HAS_DT | Das Gerät verfügt über eine dynamische Nachverfolgung. |
| ED_TRANSCAP_HAS_TIMER | Das Gerät verfügt über einen Timer. |
| ED_TRANSCAP_HAS_TUNER | Das Gerät verfügt über einen Tuner. |
| ED_TRANSCAP_IS_MASTER | Gerät ist die master Uhr für die Synchronisierung. |
| ED_TRANSCAP_MULTIPLE_EDITS | Das Gerät unterstützt mehrere Bearbeitungsereignisse. |
| ED_TRANSCAP_NEEDS_CUEING | Das Gerät muss vor dem Ausführen einer Bearbeitung cunt werden. |
| ED_TRANSCAP_NEEDS_TBC | Das Gerät muss kalibriert werden. |
Für die folgenden Flags gibt die Methode einen numerischen Wert im pValue-Parameter zurück.
| Funktionsflagge | Rückgabewert |
| ED_TRANSCAP_LTC_TRACK | Gibt die Spurnummer der LTC-Zeitcodespur zurück, oder ED_ALL, wenn keine dedizierte Timecodespur vorhanden ist. |
| ED_TRANSCAP_NUM_AUDIO_TRACKS | Gibt die Anzahl der Audiospuren zurück. |
Für die folgenden Flags gibt die Methode einen Wert im pdblValue-Parameter zurück.
| Funktionsflagge | Rückgabewert |
| ED_TRANSCAP_FWD_SHUTTLE_MAX | Maximale Vorwärtsgeschwindigkeit im Shuttlemodus, als Vielfaches der Spielgeschwindigkeit. |
| ED_TRANSCAP_FWD_SHUTTLE_MIN | Minimale Vorwärtsgeschwindigkeit im Shuttlemodus, als Vielfaches der Wiedergabegeschwindigkeit. |
| ED_TRANSCAP_FWD_VARIABLE_MAX | Maximale Vorwärtsgeschwindigkeit, als Vielfaches der Spielgeschwindigkeit. |
| ED_TRANSCAP_FWD_VARIABLE_MIN | Minimale Vorwärtsgeschwindigkeit, als Vielfaches der Spielgeschwindigkeit. |
| ED_TRANSCAP_REV_SHUTTLE_MAX | Maximale Umgekehrte Geschwindigkeit im Shuttlemodus, als Vielfaches der Wiedergabegeschwindigkeit. |
| ED_TRANSCAP_REV_SHUTTLE_MIN | Minimale Umgekehrte Geschwindigkeit im Shuttlemodus, als Vielfaches der Wiedergabegeschwindigkeit. |
| ED_TRANSCAP_REV_VARIABLE_MAX | Maximale Umgekehrte Geschwindigkeit, als Vielfaches der Wiedergabegeschwindigkeit. |
| ED_TRANSCAP_REV_VARIABLE_MIN | Minimale Umgekehrte Geschwindigkeit, als Vielfaches der Wiedergabegeschwindigkeit. |
DV-Implementierung
MSDV unterstützt diese Methode nicht. Sie 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 |