structure _BRB_GET_DEVICE_INTERFACE_STRING (bthddi.h)
La structure _BRB_GET_DEVICE_INTERFACE_STRING décrit la chaîne d’interface de l’appareil pour l’objet appareil actuel.
Syntaxe
struct _BRB_GET_DEVICE_INTERFACE_STRING {
BRB_HEADER Hdr;
PWCHAR DeviceInterfaceString;
ULONG DeviceInterfaceStringCbLength;
};
Membres
Hdr
Structure BRB_HEADER qui contient des informations sur le BRB actuel.
DeviceInterfaceString
Pointeur vers la mémoire tampon pour contenir la chaîne d’interface de l’appareil.
DeviceInterfaceStringCbLength
Lors de l’entrée, ce membre spécifie la longueur, en octets, de la chaîne d’interface de l’appareil. En sortie, ce membre spécifie le nombre d’octets requis pour la chaîne si le BRB_GET_DEVICE_INTERFACE_STRING BRB échoue et retourne STATUS_MORE_ENTRIES en raison d’une longueur de mémoire tampon insuffisante. Si l’appel BRB réussit, ce membre contient le nombre d’octets copiés.
Remarques
Pour obtenir la chaîne d’interface d’appareil pour l’objet d’appareil actuel, les pilotes de profil doivent générer et envoyer un BRB_GET_DEVICE_INTERFACE_STRING demande.
La pile de pilotes Bluetooth effectue un appel IoRegisterDeviceInterface sur chaque objet d’appareil qu’il crée. Le BRB retourne la chaîne d’interface de l’appareil retournée par cet appel. Cela peut être utile pour l’inscription aux événements.
Si la mémoire tampon pointée par le membre DeviceInterfaceString n’est pas suffisamment grande pour contenir la chaîne, l’appel échoue et le membre DeviceInterfaceStringCbLength contient la longueur de la mémoire tampon requise.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Versions :_Supported dans Windows Vista et versions ultérieures. |
| d’en-tête | bthddi.h (include Bthddi.h) |