_BRB_GET_DEVICE_INTERFACE_STRING Struktur (bthddi.h)
Die _BRB_GET_DEVICE_INTERFACE_STRING Struktur beschreibt die Geräteschnittstellenzeichenfolge für das aktuelle Geräteobjekt.
Syntax
struct _BRB_GET_DEVICE_INTERFACE_STRING {
BRB_HEADER Hdr;
PWCHAR DeviceInterfaceString;
ULONG DeviceInterfaceStringCbLength;
};
Angehörige
Hdr
Eine BRB_HEADER Struktur, die Informationen zum aktuellen BRB enthält.
DeviceInterfaceString
Ein Zeiger auf den Puffer, der die Geräteschnittstellenzeichenfolge enthält.
DeviceInterfaceStringCbLength
Bei eingaben gibt dieses Element die Länge der Geräteschnittstellenzeichenfolge in Byte an. Bei der Ausgabe gibt dieses Element die Anzahl der Bytes an, die für die Zeichenfolge erforderlich sind, wenn die BRB_GET_DEVICE_INTERFACE_STRING BRB schlägt fehl und gibt aufgrund unzureichender Pufferlänge STATUS_MORE_ENTRIES zurück. Wenn der BRB-Aufruf erfolgreich ist, enthält dieses Element die Anzahl der kopierten Bytes.
Bemerkungen
Um die Geräteschnittstellenzeichenfolge für das aktuelle Geräteobjekt abzurufen, sollten Profiltreiber erstellen und BRB_GET_DEVICE_INTERFACE_STRING Anforderung.
Der Bluetooth-Treiberstapel führt einen IoRegisterDeviceInterface- Aufruf jedes von ihr erstellten Geräteobjekts durch. Der BRB gibt die von diesem Aufruf zurückgegebene Geräteschnittstellenzeichenfolge zurück. Dies kann für die Registrierung für Ereignisse hilfreich sein.
Wenn der puffer, auf den der DeviceInterfaceString Member verweist, nicht groß genug ist, um die Zeichenfolge zu halten, schlägt der Aufruf fehl, und der DeviceInterfaceStringCbLength Member enthält die erforderliche Pufferlänge.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Versionen:_Supported in Windows Vista und höher. |
| Header- | bthddi.h (include Bthddi.h) |