IBitstreamProcessor::SetBitstreamType
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
This method sets the bit-stream type to a defined value and should be called immediately after IBitstreamProcessor::Init.
Syntax
HRESULT SetBitstreamType(
DWORD dwBitstreamType
);
Parameters
- dwBitstreamType
[in] Predefined value for a bit stream.
Return Value
The following table shows a list of possible return values.
| Return value | Description |
|---|---|
S_OK |
The request completed successfully. |
E_INVALIDARG |
The dwBitstreamType parameter was not understood. |
E_UNEXPECTED |
Initialization was unsuccessful. |
Remarks
The bit-stream microprocessor is being set to a predefined stream type that corresponds to the intended data stream type. This is accomplished by the metadriver by mapping from a requested media control interface to a data type stored in the system registry. Also during this call, DMA channels along with their role should be set up. This call should precede any DMA channel related calls.
This method can be called more than once with different types per single initialization call. All activities related to any previous bit-stream type and the DMA channels associate with it will be stopped by the client and the driver. The client software should retrieve a new set of DMA channels after a successful result from IbitStreamProcessor::SetBitstreamType.
You can define your own supported media types and associate codes. There are no pre-defined bit-stream type codes. The renderer should provide a registry key that maps the globally unique identifier (GUID) of the primary media control interface to a bit-stream type DWORD. The metarenderer will call back into a renderer with this code during initialization.
Requirements
| Header | dvddrvr.idl |
| Windows Embedded CE | Windows CE .NET 4.0 and later |