IBitstreamProcessor::SetBitstreamType (Windows Embedded CE 6.0)

1/6/2010

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

See Also

Reference

IBitstreamProcessor
IBitstreamProcessor::Init