Compartir a través de

Función BluetoothGATTBeginReliableWrite (bluetoothleapis.h)

  • Artículo

La función BluetoothGATTBeginReliableWrite especifica que las escrituras confiables están a punto de comenzar.

Sintaxis

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

Parámetros

[in] hDevice

Identificador del servicio.

[out] ReliableWriteContext

Dirección de una estructura de BTH_LE_GATT_RELIABLE_WRITE_CONTEXT que contiene el contexto que describe la operación de escritura confiable.

[in] Flags

Marcas para modificar el comportamiento de BluetoothGATTBeginReliableWrite:

Marca Descripción
BLUETOOTH_GATT_FLAG_NONE El cliente no tiene requisitos gatt específicos (valor predeterminado).

Valor devuelto

La función BluetoothGATTBeginReliableWrite devuelve los siguientes valores:

Código devuelto Descripción
S_OK
 La operación se ha completado correctamente.
ERROR_ACCESS_DENIED
 Se devuelve si se proporciona un servicio primario y un identificador de servicio y la jerarquía de servicios no se acumula en el identificador de servicio primario proporcionado.
ERROR_INVALID_FUNCTION
 Una operación de escritura confiable ya está en curso.

Comentarios

La función BluetoothGATTBeginReliableWrite notifica a la pila bluetooth que los procedimientos a los que se va a llamar después de que la función devuelva sean operaciones de escritura confiables. Las operaciones que no admiten escrituras confiables devolverán un error de ERROR_INVALID_FUNCTION . Solo las siguientes funciones admiten operaciones de escritura confiables:

Ejemplos


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);
}

Requisitos

Requisito Value
Cliente mínimo compatible Compatible con Windows 8 y versiones posteriores de Windows.
Plataforma de destino Universal
Encabezado bluetoothleapis.h
Library BluetoothAPIs.lib
Archivo DLL BluetoothAPIs.dll