|Microsoft DirectX 9.0|
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.
HRESULT EnumPort( DWORD dwIndex, LPDMUS_PORTCAPS pPortCaps );
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.
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.
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.
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.
Header: Declared in dmusicc.h.