_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 要求。

Bluetooth ドライバー スタックは、作成する各デバイス オブジェクトに 対して IoRegisterDeviceInterface 呼び出しを実行します。 BRB は、その呼び出しによって返されるデバイス インターフェイス文字列を返します。 これは、イベントの登録に役立ちます。

DeviceInterfaceString メンバーが指すバッファーが文字列を保持するのに十分な大きさでない場合、呼び出しは失敗し、DeviceInterfaceStringCbLength メンバーには必要なバッファー長が含まれます。

要件

こちらもご覧ください

BRB_HEADER

IoRegisterDeviceInterface