IDirectMusicPort8::SetReadNotificationHandle

DirectMusic

Microsoft DirectX 9.0 SDK Update (Summer 2004)

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

  Header: Declared in dmusicc.h.

See Also


© 2004 Microsoft Corporation. All rights reserved.