IOCTL_BTH_SDP_CONNECT IOCTL (bthioctl.h)
La requête 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 BTH_SDP_CONNECT qui spécifie l’adresse du serveur SDP distant, le paramètre de délai d’expiration de la requête 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 requête réussit, l'Informations membre de la structure STATUS_BLOCK est défini sur la taille, en octets, de la mémoire tampon de sortie. Dans le cas contraire, 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 | Le 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 | Il n’y avait pas suffisamment de mémoire disponible 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 bientôt de le faire. |
Remarques
La requête IOCTL_BTH_SDP_CONNECT permet à un pilote de profil d’obtenir un handle de connexion SDP sur 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Versions :_Supported dans Windows Vista et versions ultérieures. |
| d’en-tête | bthioctl.h (include Bthioctl.h) |
| IRQL | <= PASSIVE_LEVEL |