IOCTL_BTH_SDP_CONNECT IOCTL (bthioctl.h)
La demande IOCTL_BTH_SDP_CONNECT crée une connexion au service SDP sur un appareil Bluetooth distant.
Code principal
Mémoire tampon d'entrée
Le membre AssociatedIrp.SystemBuffer contient une structure de BTH_SDP_CONNECT qui spécifie l’adresse du serveur SDP distant, le paramètre de délai d’expiration de la demande et d’autres informations spécifiques à la connexion.
Longueur de la mémoire tampon d’entrée
Longueur d’une structure BTH_SDP_CONNECT .
Mémoire tampon de sortie
Le membre AssociatedIrp.SystemBuffer contient une structure BTH_SDP_CONNECT qui contient le handle de connexion SDP au serveur distant.
Longueur de la mémoire tampon de sortie
Longueur d’une structure BTH_SDP_CONNECT .
Bloc d’état
Si la demande réussit, le membre Information de la structure STATUS_BLOCK est défini sur la taille, en octets, de la mémoire tampon de sortie. Sinon, le membre Information est défini sur zéro.
Le membre Status est défini sur l’une des valeurs du tableau suivant.
| Valeur d’état | Description |
|---|---|
| STATUS_SUCCESS | L’IOCTL s’est terminé avec succès. |
| STATUS_DEVICE_BUSY | La couche HCI n’est actuellement pas en mesure d’accepter les demandes. |
| STATUS_DEVICE_NOT_CONNECTED | Si une connexion mise en cache a été spécifiée, aucun enregistrement mis en cache n’est disponible. Sinon, la connexion a été annulée avant sa fin. |
| STATUS_INSUFFICIENT_RESOURCES | La mémoire disponible était insuffisante pour traiter la demande. |
| STATUS_INVALID_PARAMETER | Une partie de la structure trouvée dans la mémoire tampon d’entrée était incorrecte. |
| STATUS_PENDING | Le système ne peut pas répondre actuellement, mais tentera de le faire sous peu. |
Remarques
La demande IOCTL_BTH_SDP_CONNECT permet à un pilote de profil d’obtenir un handle de connexion SDP à un appareil distant. Une fois le handle de connexion SDP obtenu, le pilote de profil peut le transmettre à d’autres interfaces IOCTL SDP pour collecter des informations sur le serveur SDP de l’appareil distant. Une fois les requêtes SDP terminées, le pilote de profil doit fermer la connexion SDP avec IOCTL_BTH_SDP_DISCONNECT.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Versions :_Supported dans Windows Vista et versions ultérieures. |
| En-tête | bthioctl.h (inclure Bthioctl.h) |
| IRQL | <= PASSIVE_LEVEL |