IDirectMusic8::EnumPort
Warning: This technology is deprecated as is all of DirectMusic. Deprecated components are considered obsolete. While these components are still supported, they may be removed in the future. When writing new applications, you should avoid using these deprecated components. When modifying existing applications, you are strongly encouraged to remove any dependency on these components.
Deprecated.
The EnumPort method enumerates and retrieves the capabilities of the DirectMusic ports connected to the system. Each time it is called, this method retrieves information about a single port.
Syntax
HRESULT EnumPort(
DWORD dwIndex,
LPDMUS_PORTCAPS pPortCaps
);
Parameters
dwIndex
Index of the port for which the capabilities are to be returned. This parameter should be 0 on the first call, and then incremented in each subsequent call until S_FALSE is returned.
pPortCaps
Address of the DMUS_PORTCAPS structure that receives the capabilities of the port. The dwSize member of this structure must be initialized before the pointer is passed.
Return Values
If the method succeeds, the return value is S_OK, or S_FALSE if there is no port with that index value.
If it fails, the method can return one of the error values shown in the following table.
| Return code |
| E_INVALIDARG |
| E_NOINTERFACE |
| E_POINTER |
Remarks
Applications should not rely on or store the index number of a port. Restarting the system or adding or removing ports could cause the index number of a port to change.
Requirements
** Minimum Supported Client:** Windows 2000.
** Minimum Supported Server:** Windows 2000 Server.
** Header:** Dmusicc.h
Library: Dmusic.dll
See Also