IAMExtTransport::GetTransportBasicParameters

Microsoft DirectX 8.1 (C++)

IAMExtTransport::GetTransportBasicParameters

The GetTransportBasicParameters method retrieves general properties of the external transport.

Syntax

HRESULT GetTransportBasicParameters(
  long Param,
  long *pValue,
  LPOLESTR *ppszData
);

Parameters

Param

[in] Specifies which property to receive.

pValue

[out] Pointer to a variable that receives a long integer value. See Remarks for more information.

ppszData

[out] Pointer to a variable of type LPOLESTR that receives a string. See Remarks for more information.

Return Values

When this method succeeds, it returns S_OK. Otherwise it returns an HRESULT error code.

Remarks

The Param parameter is a flag that specifies which property to retrieve. Some properties are numeric; these are returned in the pValue parameter. Other properties are string values; these are returned in the ppszData parameter. For a list of flags and expected values, see IAMExtTransport::SetTransportBasicParameters.

If the method returns a string, the caller must free the string, using the CoTaskMemFree function.

DV and MPEG Camcorder Implementation

MSDV supports the following additional flags:

ED_RAW_EXT_DEV_CMD: Invokes a raw AV/C command. Specify the AV/C command in the ppszData parameter, and the size of the command, in bytes, in the pValue parameter. When the method returns, ppszData contains the response from the device, and pValue contains the size of the response, in bytes. The AV/C command is passed directly to the device with no validation or error checking.

ED_TRANSBASIC_INPUT_SIGNAL: Retrieves the signal format that the DV camcorder is designed to accept. Returns one of the following constants in pValue.

Constant	Description
ED_TRANSBASIC_SIGNAL_525_60_SD	NTSC SD signal.
ED_TRANSBASIC_SIGNAL_525_60_SDL	NTSC SDL (long-play) signal.
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: Retrieves the signal format that the DV camcorder is designed to transmit. Returns one of the constants listed for the ED_TRANSBASIC_INPUT_SIGNAL flag.

MSTape supports additional values for ED_TRANSBASIC_INPUT_SIGNAL and ED_TRANSBASIC_INPUT_SIGNAL.

Constant	Description
ED_TRANSBASIC_SIGNAL_2500_60_MPEG	25-Mbps/60 MPEG stream.
ED_TRANSBASIC_SIGNAL_1250_60_MPEG	12.5-Mbps/60 MPEG stream.
ED_TRANSBASIC_SIGNAL_0625_60_MPEG	6.25-Mbps/60 MPEG stream.
ED_TRANSBASIC_SIGNAL_2500_50_MPEG	25-Mbps/50 MPEG stream.
ED_TRANSBASIC_SIGNAL_1250_50_MPEG	12.5-Mbps/50 MPEG stream.
ED_TRANSBASIC_SIGNAL_0625_50_MPEG	6.25-Mbps/50 MPEG stream.
ED_TRANSBASIC_SIGNAL_UNKNOWN	Unknown signal format.

These flags are defined in the header file Xprtdefs.h.

See Also