Copyright © 2005-2023 MultiMedia Soft

CallbackForSoundRecognizerEvents delegate

Previous pageReturn to chapter overviewNext page

Remarks

 

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

- SoundRecognizer.StartOnPlayer

- SoundRecognizer.StartOnFile

- SoundRecognizer.StartOnMemory

- SoundRecognizer.StartOnWasapiDevice

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

 

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.

 

For further details about callback delegates see the How to synchronize the container application with the API 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

0

A sound recognition session was started.

 

Involved data parameters:

None

EV_SOUND_RECOGNITION_DONE

1

A sound recognition session was completed.

 

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.