struttura _BRB_GET_DEVICE_INTERFACE_STRING (bthddi.h)
La struttura _BRB_GET_DEVICE_INTERFACE_STRING descrive la stringa dell'interfaccia del dispositivo per l'oggetto dispositivo corrente.
Sintassi
struct _BRB_GET_DEVICE_INTERFACE_STRING {
BRB_HEADER Hdr;
PWCHAR DeviceInterfaceString;
ULONG DeviceInterfaceStringCbLength;
};
Membri
Hdr
Struttura BRB_HEADER che contiene informazioni sull'oggetto BRB corrente.
DeviceInterfaceString
Puntatore al buffer in cui contenere la stringa dell'interfaccia del dispositivo.
DeviceInterfaceStringCbLength
In input, questo membro specifica la lunghezza, espressa in byte, della stringa dell'interfaccia del dispositivo. Nell'output, questo membro specifica il numero di byte necessari per la stringa se BRB_GET_DEVICE_INTERFACE_STRING BRB ha esito negativo e restituisce STATUS_MORE_ENTRIES a causa di una lunghezza del buffer insufficiente. Se la chiamata BRB ha esito positivo, questo membro contiene il numero di byte copiati.
Osservazioni
Per ottenere la stringa di interfaccia del dispositivo per l'oggetto dispositivo corrente, i driver del profilo devono compilare e inviare un BRB_GET_DEVICE_INTERFACE_STRING richiesta.
Lo stack di driver Bluetooth esegue un IoRegisterDeviceInterface chiamata su ogni oggetto dispositivo creato. BRB restituisce la stringa dell'interfaccia del dispositivo restituita da tale chiamata. Può essere utile per la registrazione per gli eventi.
Se il buffer a cui punta il membro DeviceInterfaceString non è sufficiente per contenere la stringa, la chiamata ha esito negativo e il membro DeviceInterfaceStringCbLength contiene la lunghezza del buffer richiesta.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Versioni:_Supported in Windows Vista e versioni successive. |
| intestazione | bthddi.h (include Bthddi.h) |