IDirectMusicPort::SetReadNotificationHandle

The IDirectMusicPort::SetReadNotificationHandle method specifies an event that is to be set when MIDI messages are available to be read with the IDirectMusicPort::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.

HRESULT SetReadNotificationHandle(
  HANDLE hEvent
);

Parameters

hEvent

Event handle obtained from a call to the the Win32 CreateEvent function. It is the application's responsibility to close this handle once the port has been released.

Return Values

The method returns S_OK.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in dmusicc.h.

See Also

Capturing Music