RequestBluetoothNotifications (Compact 2013)

  • Article

3/26/2014

This function is called by an application to register the class of events for which to receive notifications.

Syntax

HANDLE RequestBluetoothNotifications(
  DWORD dwClass,
  HANDLE hMsgQ
);

Parameters

  • dwClass
    [In] Class of events for which to receive notifications.
  • hMsgQ
    [In] Handle to the message queue that the application created.

Return Value

If no error occurs, the function returns a handle to the caller. If an error occurs the function returns NULL.

Remarks

To register for a certain class of events, specify the bitmask in dwClass. The following list shows the possible values for the class of events.

  • BTE_CLASS_CONNECTIONS
  • BTE_CLASS_PAIRING
  • BTE_CLASS_DEVICE
  • BTE_CLASS_STACK
  • BTE_CLASS_AVDTP
  • BTE_CLASS_PAN
  • BTE_CLASS_INQUIRY
  • BTE_CLASS_SSP
  • BTE_CLASS_SERVICE

In order to receive event notifications sent by the Bluetooth stack create a message queue using the CreateMsgQueue function and pass the handle it returns as the hMsgQ parameter. To terminate the event notification process, call the StopBluetoothNotifications function.

Requirements

Header

bt_api.h

Library

coredll.lib

See Also

Tasks

Stack-Events Handling Sample

Reference

Bluetooth API Notification Functions