estructura _BRB_GET_DEVICE_INTERFACE_STRING (bthddi.h)
La estructura _BRB_GET_DEVICE_INTERFACE_STRING describe la cadena de interfaz del dispositivo para el objeto de dispositivo actual.
Sintaxis
struct _BRB_GET_DEVICE_INTERFACE_STRING {
BRB_HEADER Hdr;
PWCHAR DeviceInterfaceString;
ULONG DeviceInterfaceStringCbLength;
};
Miembros
Hdr
Estructura BRB_HEADER que contiene información sobre el BRB actual.
DeviceInterfaceString
Puntero al búfer que contiene la cadena de interfaz del dispositivo.
DeviceInterfaceStringCbLength
En la entrada, este miembro especifica la longitud, en bytes, de la cadena de interfaz del dispositivo. En la salida, este miembro especifica el número de bytes necesarios para la cadena si BRB_GET_DEVICE_INTERFACE_STRING BRB produce un error y devuelve STATUS_MORE_ENTRIES debido a una longitud de búfer insuficiente. Si la llamada BRB se realiza correctamente, este miembro contiene el número de bytes copiados.
Comentarios
Para obtener la cadena de interfaz del dispositivo para el objeto de dispositivo actual, los controladores de perfil deben compilar y enviar un BRB_GET_DEVICE_INTERFACE_STRING solicitud.
La pila de controladores Bluetooth realiza una llamada IoRegisterDeviceInterface en cada objeto de dispositivo que crea. El BRB devuelve la cadena de interfaz del dispositivo devuelta por esa llamada. Esto puede ser útil para registrarse para eventos.
Si el búfer al que apunta el miembro DeviceInterfaceString no es lo suficientemente grande como para contener la cadena, se produce un error en la llamada y el miembro DeviceInterfaceStringCbLength contiene la longitud del búfer necesaria.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Versions:_Supported en Windows Vista y versiones posteriores. |
| Encabezado | bthddi.h (incluya Bthddi.h) |