IOCTL_BTH_SDP_CONNECT IOCTL (bthioctl.h)
La richiesta di IOCTL_BTH_SDP_CONNECT crea una connessione al servizio SDP in un dispositivo Bluetooth remoto.
Codice principale
Buffer di input
Il membro AssociatedIrp.SystemBuffer contiene una struttura BTH_SDP_CONNECT che specifica l'indirizzo del server SDP remoto, l'impostazione di timeout della richiesta e altre informazioni specifiche della connessione.
Lunghezza del buffer di input
Lunghezza di una struttura BTH_SDP_CONNECT .
Buffer di output
Il membro AssociatedIrp.SystemBuffer contiene una struttura BTH_SDP_CONNECT che contiene l'handle di connessione SDP al server remoto.
Lunghezza del buffer di output
Lunghezza di una struttura BTH_SDP_CONNECT .
Blocco dello stato
Se la richiesta ha esito positivo, il membro Informazioni della struttura STATUS_BLOCK viene impostato sulle dimensioni, in byte, del buffer di output. In caso contrario, il membro Informazioni è impostato su zero.
Il membro Status è impostato su uno dei valori della tabella seguente.
| Valore di stato | Descrizione |
|---|---|
| STATUS_SUCCESS | L'IOCTL è stato completato correttamente. |
| STATUS_DEVICE_BUSY | Il livello HCI non è attualmente in grado di accettare richieste. |
| STATUS_DEVICE_NOT_CONNECTED | Se è stata specificata una connessione memorizzata nella cache, non sono disponibili record memorizzati nella cache. In caso contrario, la connessione è stata annullata prima del completamento. |
| STATUS_INSUFFICIENT_RESOURCES | Memoria insufficiente per elaborare la richiesta. |
| STATUS_INVALID_PARAMETER | Una parte della struttura trovata nel buffer di input non è corretta. |
| STATUS_PENDING | Il sistema non è attualmente in grado di rispondere, ma tenterà di breve. |
Commenti
La richiesta IOCTL_BTH_SDP_CONNECT consente a un driver di profilo di ottenere un handle di connessione SDP a un dispositivo remoto. Dopo aver ottenuto l'handle di connessione SDP, il driver del profilo può passarlo ad altre interfacce IOCTL SDP per raccogliere informazioni sul server SDP del dispositivo remoto. Al termine delle query SDP, il driver del profilo deve chiudere la connessione SDP con IOCTL_BTH_SDP_DISCONNECT.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Versioni:_Supported in Windows Vista e versioni successive. |
| Intestazione | bthioctl.h (include Bthioctl.h) |
| IRQL | <= PASSIVE_LEVEL |