IBitstreamProcessor::GetLabeledDMAChannel
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 retrieves the DMA channel by its name within a specified labeling schema.
Syntax
HRESULT GetLabeledDMAChannel(
REFGUID guidLabelSystem,
WCHAR* plabelBuf,
IDMAChannel** ppDMAChannel
);
Parameters
- guidLabelSystem
[out] Labeling system.
- plabelBuf
[in] Zero-terminated label of the requested DMA channel.
- ppDMAChannel
[out] Returning IDMAChannel interface pointer.
Return Value
The following table shows a list of possible return values.
| Return value | Description |
|---|---|
S_OK |
The request completed successfully. |
E_INVALIDARG |
The requested channel is not known. |
E_UNEXPECTED |
IBitstreamProcessor::SetBitstreamType has not succeeded yet. |
E_POINTER |
An invalid argument pointer has been encountered. This is NULL for the returned value. |
E_FAIL |
A generic failure to get IDMAChannel occurred. |
Remarks
The DVD navigator reserves this function. The purpose of this function is to enable selection of a DMA channel in case of multiple channels. Because DVD uses the single channel, there is no need to differentiate. Therefore, this function is not used.
Requirements
| Header | dvddrvr.idl |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
See Also
Reference
IBitstreamProcessor::SetBitstreamType
IDMAChannel
IBitstreamProcessor