Freigeben über

IAMExtTransport::SetTransportBasicParameters-Methode (strmif.h)

  • Artikel

[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 SetTransportBasicParameters -Methode legt allgemeine Eigenschaften des Transports fest.

Syntax

HRESULT SetTransportBasicParameters(
  [in] long      Param,
  [in] long      Value,
  [in] LPCOLESTR pszData
);

Parameter

[in] Param

Gibt an, welche Eigenschaft festgelegt werden soll. Weitere Informationen finden Sie unter Hinweise.

[in] Value

Gibt den Wert der Eigenschaft als long integer an. Weitere Informationen finden Sie unter Hinweise.

[in] pszData

Gibt den Wert der Eigenschaft als LPOLESTR an. Weitere Informationen finden Sie unter Hinweise.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben. Mögliche Fehlercodes sind:

Rückgabecode Beschreibung
E_NOTIMPL
 Das Gerät unterstützt das Festlegen dieser Eigenschaft nicht.
ERROR_DEVICE_REMOVED
 Das Gerät wurde entfernt.

Hinweise

Der Parameter Param ist ein Flag, das angibt, welche Eigenschaft festgelegt werden soll. Bei einigen Flags ist die Eigenschaft numerisch; Verwenden Sie den Value-Parameter , um den Wert anzugeben. Bei anderen Flags ist die -Eigenschaft eine Zeichenfolge; Verwenden Sie den pszData-Parameter , um den Wert anzugeben. In beiden Fällen ignoriert die Methode den anderen Parameter.

Für die folgenden Flags verwendet der Value-Parameter eine definierte Konstante.

  • ED_TRANSBASIC_TIME_FORMAT: Gibt das Zeitformat an.
    Dauerhaft BESCHREIBUNG
    ED_FORMAT_MILLISECONDS Sie sollten innerhalb von Millisekunden abgeschlossen sein.
    ED_FORMAT_FRAMES Frames.
    ED_FORMAT_REFERENCE_TIME Referenzzeit.
    ED_FORMAT_HMSF Binärcodiertes Dezimalzeichen, das Stunden, Minuten, Sekunden und Frames darstellt.
    ED_FORMAT_TMSF Binärcodiertes Dezimal, das Spuren, Minuten, Sekunden und Frames darstellt.
     
  • ED_TRANSBASIC_TIME_REFERENCE: Gibt die Referenzzeit an, die vom Gerät verwendet wird.
    Dauerhaft BESCHREIBUNG
    ED_TIMEREF_TIMECODE Zeitcode.
    ED_TIMEREF_CONTROL_TRACK Steuerungsspur.
    ED_TIMEREF_INDEX Index.
    ED_TIMEREF_ATN Absolute Titelnummer. Diese Konstante ist in der Headerdatei Xprtdefs.h definiert.
     
  • ED_TRANSBASIC_END_STOP_ACTION: Gibt die Aktion an, die das Gerät ausführt, wenn es das Ende des Transportmediums erreicht.
    Dauerhaft BESCHREIBUNG
    ED_MODE_STOP Beenden
    ED_MODE_REWIND Zurückspulen.
    ED_MODE_FREEZE Fixieren/Anhalten.
     
  • ED_TRANSBASIC_RECORD_FORMAT: Gibt die Aufzeichnungsgeschwindigkeit an.
    Dauerhaft BESCHREIBUNG
    ED_RECORD_FORMAT_SP Standardspiel.
    ED_RECORD_FORMAT_LP Langes Spielen.
    ED_RECORD_FORMAT_EP Erweiterte Wiedergabe.
     
  • ED_TRANSBASIC_SUPERIMPOSE: Gibt an, ob die Bildschirmanzeige aktiviert oder deaktiviert ist.
    Dauerhaft BESCHREIBUNG
    OATRUE Die Bildschirmanzeige ist aktiviert.
    OAFALSE Die Bildschirmanzeige ist deaktiviert.
     
  • ED_TRANSBASIC_STEP_UNIT: Gibt die Schritteinheit an.
    Dauerhaft BESCHREIBUNG
    ED_STEP_FIELD Felder
    ED_STEP_FRAME Frames.
    ED_STEP_3_2 3/2 Pulldown.
     
  • ED_TRANSBASIC_SET_COUNTER_FORMAT: Legt das Zeitformat für den Indikator fest. Mögliche Werte finden Sie im Flag ED_TRANSBASIC_TIME_FORMAT.
Verwenden Sie für die folgenden Flags einen numerischen Wert im Value-Parameter .
Flag Beschreibung
ED_TRANSBASIC_STEP_COUNT Gibt die Schrittanzahl in Einheiten an, die durch das flag ED_TRANSBASIC_STEP_UNIT definiert werden.
ED_TRANSBASIC_SET_FREEZE_TIMEOUT Gibt das Timeout für den Gefriermodus in Einheiten des aktuellen Zeitformats an.
ED_TRANSBASIC_SETCLOCK Legt die Uhrzeit fest.
ED_TRANSBASIC_SET_COUNTER_VALUE Legt den Wert des Indikators fest.
 

Verwenden Sie für die folgenden Flags eine Zeichenfolge im PszData-Parameter .

Flag Beschreibung
ED_TRANSBASIC_VOLUME_NAME Gibt den Volumenamen an.
 

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

Weitere Informationen

Fehler- und Erfolgscodes

IAMExtTransport-Schnittstelle

IAMExtTransport::GetTransportBasicParameters