_BRB_GET_DEVICE_INTERFACE_STRING structure (bthddi.h)

La structure _BRB_GET_DEVICE_INTERFACE_STRING décrit la chaîne d’interface d’appareil pour l’objet d’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 à 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. Lors de la 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 de périphérique pour l’objet de périphérique 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’elle crée. Le BRB retourne la chaîne d’interface d’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 mémoire tampon requise.

Configuration requise

Voir aussi

BRB_HEADER

IoRegisterDeviceInterface