Win32 API 日本語リファレンス
ホーム › Devices.Bluetooth › PFN_DEVICE_CALLBACK

PFN_DEVICE_CALLBACK

コールバック

シグネチャ

BOOL PFN_DEVICE_CALLBACK(
    void* pvParam,
    BLUETOOTH_DEVICE_INFO* pDevice
);

パラメーター

フィールド型説明
pvParamvoid*BLUETOOTH_SELECT_DEVICE_PARAMS 構造体の pvParam メンバーから、BluetoothSelectDevices 関数を通じて渡されるパラメーターです。
pDeviceBLUETOOTH_DEVICE_INFO*照会されるリモート Bluetooth アドレスです。これは、ユーザーに提示される Bluetooth デバイスの一覧に挿入されるアドレスです。

公式ドキュメント

PFN_DEVICE_CALLBACK 関数は、Bluetooth デバイスの選択に関連して使用されるコールバックのプロトタイプです。特別なフィルター処理が必要ない場合、 PFN_DEVICE_CALLBACK 関数には NULL を設定できます。

戻り値

FALSE を返すと、そのデバイスは Bluetooth デバイスのリストビューに追加されません。

解説(Remarks)

pDevice が指す BLUETOOTH_DEVICE_INFO 構造体は、 BluetoothSelectDevices 関数が、リストビューに追加すべきかどうかを判断するために照会しているデバイスです。

コールバック内で各デバイスに対して SDP 照会を実行すると、すべてのデバイスの照会が完了するまで、ユーザーが選択できるデバイスの一覧の表示が遅れます。推奨される方法は、GET_COD_SERVICE を通じて取得できる、デバイスクラス内のサービスクラスのビットフィールドを使用して、そのデバイスをユーザーに表示すべきかどうかを判断することです。サービスクラスのビットフィールドは、pDevice パラメーターの ulClassOfDevice メンバーから利用できます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)