Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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