Callback delegates > CallbackForSoundRecognizerEvents delegate

Remarks

Occurs during a sound recognition session started through one between the following methods:

This callback can be set through a call to the CallbackForSoundRecognizerEventsSet method.

For further details about callback delegates see the How to synchronize the container application through callback delegates tutorial.

For further details about the use of the sound recognizer see the SoundRecognizerMan class.

For details about sound recognition refer to the How to recognize music and obtain related information tutorial.

Syntax

[Visual Basic]

Public Delegate Sub CallbackForSoundRecognizerEvents (

ByVal nEvent as enumSoundRecognizerEvents,

ByVal nUniqueId as Int32,

ByVal nParam1 as Int32,

ByVal nParam2 as Int32

)

[C#]

public delegate void CallbackForSoundRecognizerEvents (

enumSoundRecognizerEvents nEvent,

Int32 nUniqueId,

Int32 nParam1,

Int32 nParam2

)

[C++]

public delegate void CallbackForSoundRecognizerEvents (

enumSoundRecognizerEvents nEvent,

Int32 nUniqueId,

Int32 nParam1,

Int32 nParam2

)

Parameter

Description

nEvent

Event reported .

Supported values are the following:

Mnemonic constant

Value

Meaning with data parameters

EV_SOUND_RECOGNITION_STARTED

A sound recognition session was started. Alternative to the SoundRecognizerStarted event.

Involved data parameters:

None

EV_SOUND_RECOGNITION_DONE

A sound recognition session was completed. Alternative to the SoundRecognizerDone event.

Involved data parameters:

nParam1: The result of the recognition session, can be cast to a variable of type enumErrorCodes: see the LastError property for supported values

nUniqueId

Number representing the unique identifier of the recognition session started by one of the following methods:

SoundRecognizer.StartOnPlayer

SoundRecognizer.StartOnFile

SoundRecognizer.StartOnMemory

SoundRecognizer.StartOnWasapiDevice

nParam1

First 32 bits integer value containing event specific data; its value and meaning depends upon the specific event received: see the table above for possible values.

nParam2

Second 32 bits integer value containing event specific data; currently reserved for future uses.