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.

Bemerkungen

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. Es wird E_NOTIMPL zurückgegeben.

Anforderungen

   
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

Siehe auch

Fehler- und Erfolgscodes

IAMExtTransport-Schnittstelle