IDirectSoundNotify8 Interface

' ***************************************************************************************
' IDirectSoundNotify8 Interface
' The IDirectSoundNotify8 interface sets up notification events for a playback or capture
' buffer. IDirectSoundNotify8 is a define for IDirectSoundNotify. The two interface names
' are interchangeable. The interface is obtained by calling the QueryInterface method of
' an existing interface on a DirectSound buffer object. Secondary buffers support
' notifications only if they are created with the DSBCAPS_CTRLPOSITIONNOTIFY flag.
' ***************************************************************************************

' ***************************************************************************************
'DECLARE_INTERFACE_(IDirectSoundNotify, IUnknown)
'{
'    // IUnknown methods
'  0.  STDMETHOD(QueryInterface)           (THIS_ REFIID, LPVOID *) PURE;
'  1.  STDMETHOD_(ULONG,AddRef)            (THIS) PURE;
'  2.  STDMETHOD_(ULONG,Release)           (THIS) PURE;

'    // IDirectSoundNotify methods
'  3.  STDMETHOD(SetNotificationPositions) (THIS_ DWORD dwPositionNotifies, LPCDSBPOSITIONNOTIFY pcPositionNotifies) PURE;
'};
' ***************************************************************************************

' ***************************************************************************************
' SetNotificationPositions
' The SetNotificationPositions method sets the notification positions. During capture or
' playback, whenever the read or play cursor reaches one of the specified offsets, the
' associated event is signaled.
' HRESULT SetNotificationPositions(
'   DWORD dwPositionNotifies,
'   LPCDSBPOSITIONNOTIFY pcPositionNotifies
' );
' ***************************************************************************************
FUNCTION IDirectSoundNotify8_SetNotificationPositions ALIAS "IDirectSoundNotify8_SetNotificationPositions" ( _
    BYVAL pthis AS DWORD PTR, BYVAL dwPositionNotifies AS DWORD, BYVAL pcPositionNotifies AS DWORD) EXPORT AS LONG

    LOCAL HRESULT AS LONG
    IF pthis = %NULL THEN FUNCTION = %E_POINTER : EXIT FUNCTION
    CALL DWORD @@pthis[3] USING IDirectSoundNotify8_SetNotificationPositions(pthis, dwPositionNotifies, pcPositionNotifies) TO HRESULT
    FUNCTION = HRESULT

END FUNCTION
' ***************************************************************************************