DMOGetName function (dmoreg.h)
[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.]
The DMOGetName function retrieves the name of a DMO from the registry.
Syntax
HRESULT DMOGetName(
REFCLSID clsidDMO,
WCHAR [80] szName
);
Parameters
clsidDMO
Class identifier (CLSID) of the DMO.
szName
Array of 80 Unicode characters that receives the name of the DMO. The caller must allocate the array. The name is a NULL-terminated string.
Return value
Returns an HRESULT value. Possible values include the following.
| Return code | Description |
|---|---|
|
Failure |
|
No name was registered for this DMO, or the name has zero length. |
|
Success |
Remarks
If the method returns S_FALSE, szName is set to '\0'.
Requirements
| Target Platform | Windows |
| Header | dmoreg.h (include Dmo.h) |
| Library | Msdmo.lib |
| DLL | Msdmo.dll |