BLUETOOTH_SELECT_DEVICE_PARAMS構造 (bluetoothapis.h)

  • [アーティクル]

BLUETOOTH_SELECT_DEVICE_PARAMS構造により、Bluetooth デバイスとサービスの可視性、認証、選択が容易になり、管理されます。

構文

typedef struct _BLUETOOTH_SELECT_DEVICE_PARAMS {
  DWORD                  dwSize;
  ULONG                  cNumOfClasses;
  BLUETOOTH_COD_PAIRS    *prgClassOfDevices;
  LPWSTR                 pszInfo;
  HWND                   hwndParent;
  BOOL                   fForceAuthentication;
  BOOL                   fShowAuthenticated;
  BOOL                   fShowRemembered;
  BOOL                   fShowUnknown;
  BOOL                   fAddNewDeviceWizard;
  BOOL                   fSkipServicesPage;
  PFN_DEVICE_CALLBACK    pfnDeviceCallback;
  LPVOID                 pvParam;
  DWORD                  cNumDevices;
  PBLUETOOTH_DEVICE_INFO pDevices;
} BLUETOOTH_SELECT_DEVICE_PARAMS;

メンバー

dwSize

BLUETOOTH_SELECT_DEVICE_PARAMS構造体のサイズ (バイト単位)。

cNumOfClasses

prgClassOfDevices 内のクラスの数。 すべてのデバイスを検索するには、0 に設定します。

prgClassOfDevices

検索するデバイスのクラスの配列。

pszInfo

NULL でない場合に情報テキストを設定 します。

hwndParent

親ウィンドウにハンドルします。 親がない場合は NULL に設定します。

fForceAuthentication

TRUE の場合は、 が返される前に認証が強制されます。

fShowAuthenticated

TRUE の場合、認証されたデバイスが選択ウィンドウに表示されます。

fShowRemembered

TRUE の場合、記憶されているデバイスが選択ウィンドウに表示されます。

fShowUnknown

TRUE の場合、認証または記憶されていない不明なデバイスがピッカーに表示されます。

fAddNewDeviceWizard

TRUE の場合は、新しいデバイスの追加ウィザードを開始します。

fSkipServicesPage

TRUE の場合、新しいデバイスの追加ウィザードの [サービス] ページをスキップします。

pfnDeviceCallback

各デバイスに対して呼び出されるコールバック関数へのポインター。 コールバック関数が TRUE を返す場合、項目が追加されます。 コールバック関数が FALSE を返した場合、項目は表示されません。 コールバックがない場合は 、pfnDeviceCallback を null に設定します。 詳細については、「 PFN_DEVICE_CALLBACK」を参照してください。

pvParam

pfnDeviceCallback で指されるコールバック関数に pvParam として渡されるパラメーター。

cNumDevices

入力時に、目的の呼び出しの数を指定します。 制限がない場合は 0 に設定します。 出力時に、 は返されるデバイスの数を返します。

pDevices

BLUETOOTH_DEVICE_INFO構造体の配列へのポインター。

注釈

pDevices メンバーで渡されたBLUETOOTH_DEVICE_INFO構造体の配列を解放するには、BluetoothSelectDevicesFree 関数を呼び出します。

要件

要件 値
サポートされている最小のクライアント Windows Vista、WINDOWS XP と SP2 [デスクトップ アプリのみ]
サポートされている最小のサーバー サポートなし
Header bluetoothapis.h (Bthsdpdef.h、BluetoothAPIs.h を含む)

こちらもご覧ください

BLUETOOTH_COD_PAIRS

BLUETOOTH_DEVICE_INFO

BluetoothSelectDevices

BluetoothSelectDevicesFree

PFN_DEVICE_CALLBACK