_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 成員包含所需的緩衝區長度。

要求

另請參閱

BRB_HEADER

IoRegisterDeviceInterface