| 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.