CMediaControl.GetIDsOfNames method
[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
Maps a single member function and an optional set of parameters to a corresponding set of integer dispatch identifiers (DISPIDs), which can be used upon subsequent calls to the CMediaControl::Invoke member function.
Syntax
HRESULT GetIDsOfNames(
REFIID riid,
OLECHAR **rgszNames,
UINT cNames,
LCID lcid,
DISPID *rgdispid
);
Parameters
-
riid
-
Reference identifier. Reserved for future use. Must be NULL.
-
rgszNames
-
Address of a pointer to a passed-in array of names to be mapped.
-
cNames
-
Count of the names to be mapped.
-
lcid
-
Locale context in which to interpret the names.
-
rgdispid
-
Pointer to a caller-allocated array, each element of which contains an ID corresponding to one of the names passed in the rgszNames array. The first element represents the member name; the subsequent elements represent each of the member's parameters.
Return value
Returns one of the following values.
| Return code | Description |
|---|---|
|
The CLSID was not recognized. |
|
One or more of the names were not known. The returned DISPIDs contain DISPID_UNKNOWN for each entry that corresponds to an unknown name. |
|
Out of memory. |
|
Success. |
Requirements
| Requirement | Value |
|---|---|
| Header |
|
| Library |
|