Index

DXMediaStreamInfoDL

Purpose:

The DXMediaStreamInfoDL class defines the properties and other information required by Content Manager datastore media objects.

Methods:

getMediaFullFileName
BSTR getMediaFullFileName();

Gets the fully qualified directory path and file name (the control information). If the media object data is stored in a single file, then FullFileName becomes the media object. If the media object data is stored in multiple files, then FullFileName will contain a list of the media object segment files and their respective path names.

setMediaFullFileName
setMediaFullFileName(LPCTSTR aFullFileName);

Sets the fully qualified directory path and file name (the control information). If the media object data is stored in a single file, then FullFileName becomes the media object. If the media object data is stored in multiple files, then FullFileName will contain a list of the media object segment files and their respective path names.

The drive, directory path, and file name are stored as a string in the client data space. This string may contain up to 128 characters. The file name must conform to the standard 8:3 format (1 to 8 characters for the file name and 0 to 3 characters for the extension); the Content Manager datastore does not currently support long file names.

getMediaObjectOption
long getMediaObjectOption();

Gets the object option that indicates whether the media object data is stored in a single file or in multiple files.

setMediaObjectOption
setMediaObjectOption(long aObjectOption);

Sets the object option that indicates whether the media object data is stored in a single file or in multiple files. The valid values are:

DX_DL_VS_SINGLEOBJECT
the value of fullFileName that the setMediaFullFileName method specifies will be passed to the object server for FTP processing

DX_DL_VS_LIST_OF_OBJECT_SEGMENTS
the value of fullFileName that the setMediaFullFileName method specifies will consist of a list of object segments and their respective paths. This information will be passed to the object server for FTP processing

setMediaHostName
setMediaHostName(LPCTSTR aHostName);

Sets the host name of the machine where the media object data file resides. This machine is not necessarily the same as the Content Manager system. The user ID and password used to access the system may not allow the video server to access the files on the system.

setMediaUserId
setMediaUserId(LPCTSTR aUserId);

Sets the user ID that will connect to the host name where the media object data file resides. The user ID will also perform the FTP file transfer over the video server.

setMediaPassword
setMediaPassword(LPCTSTR aPassword);

Sets the password for the user ID, allowing the user ID to perform the FTP file transfer over the video server.

getMediaCopyRate
long getMediaCopyRate();

Gets the copy rate at which data will be transferred.

setMediaCopyRate
setMediaCopyRate(long aCopyRate);

Sets the copy rate at which data will be transferred. This method is optional.

getMediaInvalidCommands
long getMediaInvalidCommands();

Gets invalid commands for the video player control mask.

setMediaInvalidCommands
setMediaInvalidCommands(long aInvalidCommands);

Sets invalid commands for the video player control mask. This method is optional.

getMediaDurSeconds
long getMediaDurSeconds();

Gets the media duration as a value that equates to the number of seconds.

setMediaDurSeconds
setMediaDurSeconds(long aDurSeconds);

Sets the media duration as a value that equates to the number of seconds. This method is optional.

getMediaDurFrames
long getMediaDurFrames();

Gets the media duration as a value that equates to the number of frames.

setMediaDurFrames
setMediaDurFrames(long aDurFrames);

Sets the media duration as a value that equates to the number of frames. This method is optional.

getMediaFrameRate
long getMediaFrameRate();

Gets the media frame rate multiplied by 100. This value is stored at 100 times the actual value. For example, the number 29.97 would be stored as 2997.

setMediaFrameRate
setMediaFrameRate(long aFrameRate);

Sets the media frame rate multiplied by 100. This value should be 100 times the actual value. For example, the number 29.97 would be stored as 2997. This method is optional.

getMediaBitRate
long getMediaBitRate();

Gets the total multiplexed media bit rate.

setMediaBitRate
setMediaBitRate(long aBitRate);

Sets the total multiplexed media bit rate. This method is optional.

getMediaNumberOfUsers
long getMediaNumberOfUsers();

Gets the number of media users allowed to stream the media object data concurrently.

setMediaNumberOfUsers
setMediaNumberOfUsers(long aNumberOfUsers);

Sets the number of media users allowed to stream the media object data concurrently. The default value is 1.

getMediaAssetGroup
BSTR getMediaAssetGroup();

Gets the name of the video server asset group. This value is alphanumeric and can be up to 120 characters in length.

setMediaAssetGroup
setMediaAssetGroup(LPCTSTR aAssetGroup);

Sets the name of the video server asset group. This value is alphanumeric and can be up to 120 characters in length. The default value is "AG."

getMediaType
BSTR getMediaType();

Gets the media type that describes the file format of a media asset (media object data).

setMediaType
setMediaType(LPCTSTR aType);

Sets the media type that describes the file format of a media asset (media object data). This value is alphanumeric and can be up to 16 characters in length. The currently supported values are:

getMediaResolution
BSTR getMediaResolution();

Gets the media resolution.

setMediaResolution
setMediaResolution(LPCTSTR aResolution);

Sets the media resolution. This value is alphanumeric and can be up to 16 characters in length. The currently supported values are:

getMediaStandard
BSTR getMediaStandard();

Gets the media standard that is currently being used.

setMediaStandard
setMediaStandard(LPCTSTR aStandard);

Sets the media standard. This value is alphanumeric and can be up to 16 characters in length. The currently supported values are:

getMediaFormat
BSTR getMediaFormat();

Gets the streaming type of video asset (media object data).

setMediaFormat
setMediaFormat(LPCTSTR aFormat);

Sets the streaming type of video asset (media object data). This value is alphanumeric and can be up to 16 characters in length. The currently supported values are:

getMediaState
setMediaState(long aState);

Gets the state of the media object. The valid values are:

1
pending, load in progress

2
load completed successfully

3
load failed

GetMediaTimestamp
BSTR getMediaTimestamp();

Gets the timestamp when the media object is stored.

setMediaTimestamp
setMediaTimestamp(LPCTSTR aTimestamp);

Sets the timestamp when the media object is stored.

(c) Copyright International Business Machines Corporation 1996, 2002. IBM Corp. All rights reserved.