Microsoft DirectX 8.0 (C++) |
Adds a notification type. This method is called by the IDirectMusicPerformance8::AddNotificationType method, allowing the segment to respond to notifications. The segment calls each track's IDirectMusicTrack8::AddNotificationType method.
HRESULT AddNotificationType( REFGUID rguidNotificationType );
DirectSound does not initialize the contents of the buffer, and the application cannot assume that it contains silence.
If an attempt is made to create a buffer with the DSBCAPS_LOCHARDWARE flag on a system where hardware acceleration is not available, the method fails with DSERR_CONTROLUNAVAIL on Windows 95 and Windows 98. On Windows 2000, it returns DSERR_INVALIDCALL.
the return value is S_OK.
If it fails, the method can return one of the following error values:
E_POINTER |
E_OUTOFMEMORY |
Segments cannot generate notifications of type GUID_NOTIFICATION_PERFORMANCE. To get notifications of this type, you must call IDirectMusicPerformance8::AddNotificationType.
Header: Declared in dmusici.h.