IWMEncDataViewCollection Interface
.gif) |
The IWMEncDataViewCollection interface contains a collection of data view objects used by Windows Media Encoder to display multimedia content. The most common examples are preview and postview objects. A preview object displays a specific multimedia stream before it is compressed. A postview object displays the same stream after compression and decompression. Postviews, therefore, more closely resemble the image rendered in Windows Media Player on a client computer.
A single data view object is generally associated with only one source stream in one source group but can be shared by multiple sources. For example, you can render both a live presentation and a bitmap intermission slide in the same video window by sharing a data view object between the two sources.
You can add multiple data view objects to a single source. For instance, one object might simply render a video or audio stream, and another object might use periods of inactivity in the encoded stream to send an e-mail message.
All of the data view objects associated with a stream are grouped together in a collection. Multiple collections exist if multiple streams are associated with data view objects. A data view collection is acquired from the IWMEncSource interface.
In addition to the methods inherited from IDispatch, the IWMEncDataViewCollection interface exposes the following methods.
| Method | Description |
| Add | Adds an IWMEncDataView object to the collection. |
| get_Count | Retrieves the number of IWMEncDataView objects in the collection. |
| get_length | Retrieves the number of IWMEncDataView objects in the collection. |
| Item | Retrieves a specific IWMEncDataView object from the collection. |
| Remove | Removes a specific IWMEncDataView object from the collection. |
| RemoveAll | Removes all IWMEncDataView objects from the collection. |
See Also