_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;
};

Member

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 der Eingabe gibt dieses Member die Länge der Geräteschnittstellenzeichenfolge in Bytes an. In der Ausgabe gibt dieses Element die Anzahl der Bytes an, die für die Zeichenfolge erforderlich sind, wenn BRB_GET_DEVICE_INTERFACE_STRING BRB schlägt fehl und gibt STATUS_MORE_ENTRIES aufgrund unzureichender Pufferlänge zurück. Wenn der BRB-Aufruf erfolgreich ist, enthält dieses Element die Anzahl der kopierten Bytes.

Hinweise

Um die Geräteschnittstellenzeichenfolge für das aktuelle Geräteobjekt abzurufen, sollten Profiltreiber einen erstellen und senden . BRB_GET_DEVICE_INTERFACE_STRING Anforderung.

Der Bluetooth-Treiberstapel führt einen IoRegisterDeviceInterface-Aufruf für jedes von ihr erstellte Geräteobjekt aus. Der BRB gibt die von diesem Aufruf zurückgegebene Geräteschnittstellenzeichenfolge zurück. Dies kann für die Registrierung für Ereignisse nützlich sein.

Wenn der Puffer, auf den das DeviceInterfaceString-Element verweist, nicht groß genug ist, um die Zeichenfolge zu halten, schlägt der Aufruf fehl, und das DeviceInterfaceStringCbLength-Element enthält die erforderliche Pufferlänge.

Anforderungen

Weitere Informationen

BRB_HEADER

IoRegisterDeviceInterface