IAMExtTransport::SetTransportBasicParameters-Methode (strmif.h)

[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