Fonction BluetoothGATTBeginReliableWrite (bluetoothleapis.h)

Article
02/26/2024

La fonction BluetoothGATTBegin ReliableWrite spécifie que les écritures fiables sont sur le point de commencer.

Syntaxe

HRESULT BluetoothGATTBeginReliableWrite(
  [in]  HANDLE                              hDevice,
  [out] PBTH_LE_GATT_RELIABLE_WRITE_CONTEXT ReliableWriteContext,
  [in]  ULONG                               Flags
);

Paramètres

[in] hDevice

Handle au service.

[out] ReliableWriteContext

Adresse d’une structure de BTH_LE_GATT_RELIABLE_WRITE_CONTEXT contenant le contexte décrivant l’opération d’écriture fiable.

[in] Flags

Indicateurs permettant de modifier le comportement de BluetoothGATTBeginReliableWrite :

Indicateur	Description
BLUETOOTH_GATT_FLAG_NONE	Le client n’a pas d’exigences GATT spécifiques (par défaut).

Valeur retournée

La fonction BluetoothGATTBeginReliableWrite retourne les valeurs suivantes :

Code de retour	Description
S_OK	L’opération s’est terminée avec succès.
ERROR_ACCESS_DENIED	Retourné si un service parent et un handle de service sont fournis et que la hiérarchie de service ne se cumule pas sur le handle de service parent fourni.
ERROR_INVALID_FUNCTION	Une opération d’écriture fiable est déjà en cours.

Remarques

La fonction BluetoothGATTBegin ReliableWrite informe la pile Bluetooth que les procédures qui doivent être appelées après le retour de la fonction sont des opérations d’écriture fiables. Toutes les opérations qui ne prennent pas en charge les écritures fiables retournent une erreur ERROR_INVALID_FUNCTION . Seules les fonctions suivantes prennent en charge les opérations d’écriture fiables :

Exemples


BTH_LE_GATT_RELIABLE_WRITE_CONTEXT ReliableWriteContext = NULL;
hr = BluetoothGATTBeginReliableWrite(hDevice, 
                                    &ReliableWriteContext,
                                    BLUETOOTH_GATT_FLAG_NONE);

if (SUCCEEDED(hr)) {
    // Calls to BluetoothGATTSetCharacteristicValue
}

if (NULL != ReliableWriteContext) {
    BluetoothGATTEndReliableWrite(hDevice, 
                                 ReliableWriteContext,
                                  BLUETOOTH_GATT_FLAG_NONE);
}

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge dans Windows 8 et versions ultérieures de Windows.
Plateforme cible	Universal
En-tête	bluetoothleapis.h
Bibliothèque	BluetoothAPIs.lib
DLL	BluetoothAPIs.dll

Partager via