IAMExtTransport::GetTransportBasicParameters-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 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