IDirectMusicPort8::SetReadNotificationHandle
The SetReadNotificationHandle method specifies an event that is to be set when MIDI messages are available to be read with the IDirectMusicPort8::Read method. The event is signaled whenever new data is available. To turn off event notification, call SetReadNotificationHandle with a NULL value for the hEvent parameter.
Syntax
HRESULT SetReadNotificationHandle(
HANDLE
hEvent
);
Parameters
hEvent
Event handle obtained from a call to the Win32 CreateEvent function. It is the application's responsibility to close this handle after the port has been released.
Return Values
If it succeeds, the method returns S_OK.
If it fails, the method can return one of the error values shown in the following table.
| Return code |
| DMUS_E_DMUSIC_RELEASED |
| E_NOTIMPL |
Remarks
A return value of E_NOTIMPL can mean the port is not an input port.
Requirements
** Minimum Supported Client:** Windows 2000.
** Minimum Supported Server:** Windows 2000 Server.
** Header:** Dmusicc.h
See Also