IAMExtTransport::GetTransportBasicParameters-Methode (strmif.h)

Artikel
03/04/2024

[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 GetTransportBasicParameters -Methode ruft allgemeine Eigenschaften des externen Transports ab.

Syntax

HRESULT GetTransportBasicParameters(
  [in]      long     Param,
  [in, out] long     *pValue,
  [in, out] LPOLESTR *ppszData
);

Parameter

[in] Param

Gibt an, welche Eigenschaft empfangen werden soll.

[in, out] pValue

Zeiger auf eine Variable, die einen langen ganzzahligen Wert empfängt. Weitere Informationen finden Sie unter Hinweise.

[in, out] ppszData

Zeiger auf eine Variable vom Typ LPOLESTR , die eine Zeichenfolge empfängt. 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.

Hinweise

Der Parameter Param ist ein Flag, das angibt, welche Eigenschaft abgerufen werden soll. Einige Eigenschaften sind numerisch; diese werden im pValue-Parameter zurückgegeben. Andere Eigenschaften sind Zeichenfolgenwerte; diese werden im ppszData-Parameter zurückgegeben. Eine Liste der Flags und erwarteten Werte finden Sie unter IAMExtTransport::SetTransportBasicParameters.

Wenn die Methode eine Zeichenfolge zurückgibt, muss der Aufrufer die Zeichenfolge mit der Funktion CoTaskMemFree freigeben.

DV- und MPEG-Camcorderimplementierung

MSDV unterstützt die folgenden zusätzlichen Flags:

ED_RAW_EXT_DEV_CMD: Ruft einen unformatierten AV/C-Befehl auf. Geben Sie den AV/C-Befehl als Array von Bytes im ppszData-Parameter an. Geben Sie die Größe des Befehls in Bytes im pValue-Parameter an. Wenn die Methode zurückgibt, enthält ppszData die Antwort des Geräts, und pValue enthält die Größe der Antwort in Bytes. Der AV/C-Befehl wird ohne Validierung oder Fehlerüberprüfung direkt an das Gerät übergeben.
Die Antwortnutzlast kann größer als der Befehl sein. Es liegt in der Verantwortung des Aufrufers, genügend Speicherplatz im Puffer für die Antwort zuzuweisen. Die maximale Nutzlastgröße beträgt 512 Byte.

Weitere Informationen finden Sie unter Ausgeben von AV/C-Rohbefehlen.

ED_TRANSBASIC_INPUT_SIGNAL: Ruft das Signalformat ab, das der DV-Camcorder akzeptiert. Gibt eine der folgenden Konstanten in pValue zurück.

Dauerhaft	BESCHREIBUNG
ED_TRANSBASIC_SIGNAL_525_60_SD	NTSC SD-Signal.
ED_TRANSBASIC_SIGNAL_525_60_SDL	NTSC SDL-Signal (Long-Play).
ED_TRANSBASIC_SIGNAL_625_50_SD	PAL SD-Signal.
ED_TRANSBASIC_SIGNAL_625_50_SDL	PAL SDL(Long-Play)-Signal.
ED_TRANSBASIC_SIGNAL_MPEG2TS	D-VHS-Signal.

ED_TRANSBASIC_OUTPUT_SIGNAL: Ruft das Signalformat ab, das der DV-Camcorder übertragen soll. Gibt eine der Konstanten zurück, die für das flag ED_TRANSBASIC_INPUT_SIGNAL aufgeführt sind.

MSTape unterstützt zusätzliche Werte für ED_TRANSBASIC_INPUT_SIGNAL und ED_TRANSBASIC_OUTPUT_SIGNAL.

Dauerhaft	BESCHREIBUNG
ED_TRANSBASIC_SIGNAL_2500_60_MPEG	MPEG-Stream mit 25 MBit/s/60.
ED_TRANSBASIC_SIGNAL_1250_60_MPEG	MPEG-Stream mit 12,5 MBit/s/60.
ED_TRANSBASIC_SIGNAL_0625_60_MPEG	6,25 MBit/s/60 MPEG-Stream.
ED_TRANSBASIC_SIGNAL_2500_50_MPEG	MPEG-Stream mit 25 MBit/s/50.
ED_TRANSBASIC_SIGNAL_1250_50_MPEG	12,5 MBit/s/50 MPEG-Stream.
ED_TRANSBASIC_SIGNAL_0625_50_MPEG	6,25 MBit/s/50 MPEG-Stream.
ED_TRANSBASIC_SIGNAL_UNKNOWN	Unbekanntes Signalformat.

Diese Flags sind in der Headerdatei Xprtdefs.h definiert.

In Windows XP Service Pack 2 und höher werden die folgenden zusätzlichen Signaltypen für die flags ED_TRANSBASIC_INPUT_SIGNAL und ED_TRANSBASIC_OUTPUT_SIGNAL definiert.

Dauerhaft	BESCHREIBUNG
ED_TRANSBASIC_SIGNAL_525_60_DV25	DVCPRO 25, 525-60.
ED_TRANSBASIC_SIGNAL_625_50_DV25	DVCPRO 25, 625-50.
ED_TRANSBASIC_SIGNAL_525_60_DV50	DVCPRO 50, 525-60.
ED_TRANSBASIC_SIGNAL_625_50_DV50	DVCPRO 50, 625-50.
ED_TRANSBASIC_SIGNAL_HD_60_DVH1	DVCPRO 100, 1080i oder 720p
ED_TRANSBASIC_SIGNAL_HD_50_DVH1	Nur DVCPRO 100, 1080i

Um diese Konstanten zu verwenden, schließen Sie die Headerdatei Xprtdefs.h aus dem Windows SDK ein.

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

Freigeben über