Funzione BluetoothGATTBeginReliableWrite (bluetoothleapis.h)

Articolo
02/23/2024

La funzione BluetoothGATTBeginReliableWrite specifica che le scritture affidabili stanno per iniziare.

Sintassi

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

Parametri

[in] hDevice

Gestire il servizio.

[out] ReliableWriteContext

Indirizzo di una struttura BTH_LE_GATT_RELIABLE_WRITE_CONTEXT contenente il contesto che descrive l'operazione di scrittura affidabile.

[in] Flags

Flag per modificare il comportamento di BluetoothGATTBeginReliableWrite:

Flag	Descrizione
BLUETOOTH_GATT_FLAG_NONE	Il client non ha requisiti GATT specifici (impostazione predefinita).

Valore restituito

La funzione BluetoothGATTBeginReliableWrite restituisce i valori seguenti:

Codice restituito	Descrizione
S_OK	Operazione riuscita.
ERROR_ACCESS_DENIED	Restituito se vengono forniti sia un servizio padre che un handle di servizio e la gerarchia del servizio non viene rollup nell'handle del servizio padre fornito.
ERROR_INVALID_FUNCTION	È già in corso un'operazione di scrittura affidabile.

Commenti

La funzione BluetoothGATTBeginReliableWrite notifica allo stack Bluetooth che le procedure da chiamare dopo la restituzione della funzione sono operazioni di scrittura affidabili. Tutte le operazioni che non supportano scritture affidabili restituiranno un errore ERROR_INVALID_FUNCTION . Solo le funzioni seguenti supportano operazioni di scrittura affidabili:

Esempio


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

Requisiti

Requisito	Valore
Client minimo supportato	Supportato in Windows 8 e versioni successive di Windows.
Piattaforma di destinazione	Universale
Intestazione	bluetoothleapis.h
Libreria	BluetoothAPIs.lib
DLL	BluetoothAPIs.dll

Condividi tramite