IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH IOCTL (bthioctl.h)
La requête IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH combine un service SDP et une recherche d’attribut en une seule opération. Cela permet à un appelant d’obtenir directement des enregistrements SDP à partir d’un appareil distant.
Code principal
Mémoire tampon d'entrée
Le membre AssociatedIrp.SystemBuffer contient un IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH structure qui spécifie le handle de connexion au serveur SDP distant, un tableau de GUID et la plage de valeurs d’attribut à rechercher.
Longueur de la mémoire tampon d’entrée
Longueur d’un IOCTL_BTH_SDP_SERVICE_ATTRIBUTE_SEARCH structure.
Mémoire tampon de sortie
Le membre AssociatedIrp.SystemBuffer pointe vers une mémoire tampon qui contient une structure BTH_SDP_STREAM_RESPONSE suivie d’un flux d’enregistrements SDP brut.
Longueur de la mémoire tampon de sortie
Longueur d’une structure BTH_SDP_STREAM_RESPONSE .
Bloc d’état
Si la demande réussit, le membre Information de la structure STATUS_BLOCK est défini sur la taille, en octets, du flux de réponse SDP ou de la taille de la mémoire tampon de sortie, selon la valeur la plus petite. 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_NOT_CONNECTED | L’appareil sur lequel réside le service SDP n’était pas connecté. |
| STATUS_INSUFFICIENT_RESOURCES | La mémoire n’était pas suffisante pour effectuer cette opération. |
| STATUS_INVALID_BUFFER_SIZE | La mémoire tampon de sortie a été mal dimensionnée. |
| STATUS_INVALID_PARAMETER | L’une des valeurs de la mémoire tampon d’entrée n’était pas valide. |
| STATUS_REQUEST_NOT_ACCEPTED | Le service SDP a rejeté la demande. |
| STATUS_TOO_MANY_GUIDS_REQUESTED | Le service SDP n’a pas pu traiter le nombre de GUID passés dans la mémoire tampon d’entrée. |
Remarques
Une fois qu’un pilote de profil a obtenu un enregistrement SDP, il peut utiliser des fonctions SDP pour les analyser. Les pointeurs vers ces fonctions sont fournis par le interface BTHDDI_SDP_PARSE_INTERFACE .
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 |