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.

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.

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

Anforderungen

Weitere Informationen

Fehler- und Erfolgscodes

IAMExtTransport-Schnittstelle