_BRB_GET_DEVICE_INTERFACE_STRING 結構 (bthddi.h)
_BRB_GET_DEVICE_INTERFACE_STRING結構描述目前裝置對象的裝置介面字串。
語法
struct _BRB_GET_DEVICE_INTERFACE_STRING {
BRB_HEADER Hdr;
PWCHAR DeviceInterfaceString;
ULONG DeviceInterfaceStringCbLength;
};
成員
Hdr
包含目前 BRB 相關信息 的BRB_HEADER 結構。
DeviceInterfaceString
要包含裝置介面字串之緩衝區的指標。
DeviceInterfaceStringCbLength
在輸入時，這個成員會指定裝置介面字串的長度，以位元組為單位。 在輸出時，如果 ，這個成員會指定字串所需的位元組數目 BRB_GET_DEVICE_INTERFACE_STRING BRB 失敗並傳回STATUS_MORE_ENTRIES，因為緩衝區長度不足。 如果 BRB 呼叫成功，此成員會包含複製的位元元組數目。
備註
若要取得目前裝置物件的裝置介面字串，配置檔驅動程序應該建置並傳送 BRB_GET_DEVICE_INTERFACE_STRING 要求。
藍牙驅動程式堆疊會在它建立的每個裝置對象上執行 IoRegisterDeviceInterface 呼叫。 BRB 會傳回該呼叫所傳回的裝置介面字串。 這適用於註冊事件。
如果 DeviceInterfaceString 成員指向的緩衝區不夠大，無法保存字串，則呼叫會失敗，而 DeviceInterfaceStringCbLength 成員包含所需的緩衝區長度。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista 和更新版本中的版本：_Supported。 |
| 標頭 | bthddi.h (包含 Bthddi.h) |