| Microsoft DirectX 8.1 (C++) |
The CreateClassEnumerator method creates an enumerator for a specified device category.
Syntax
HRESULT CreateClassEnumerator(
REFCLSID clsidDeviceClass,
IEnumMoniker **ppEnumMoniker,
DWORD dwFlags
);
Parameters
clsidDeviceClass
[in] Specifies the class identifier (CLSID) of the device category. See Filter Categories.
ppEnumMoniker
[out] Address of a variable that receives an IEnumMoniker interface pointer.
dwFlags
[in] Reserved. Must be 0.
Return Values
Returns one of the following HRESULT values.
| Return code | Description |
| S_OK | Success. |
| E_OUTOFMEMORY | There is not enough memory available to create a class enumerator. |
| S_FALSE | The category specified by clsidDeviceClass does not exist or is empty. |
| E_POINTER | NULL pointer argument. |
Remarks
If the category does not exist or is empty, the return value is S_FALSE, and the ppEnumMoniker parameter receives the value NULL.
The returned IEnumMoniker interface has an outstanding reference count. The caller must release the interface.
See Also