SP_SELECTDEVICE_PARAMS_W構造体 (setupapi.h)

SP_SELECTDEVICE_PARAMS構造体は、 DIF_SELECTDEVICE インストール要求に対応します。

構文

typedef struct _SP_SELECTDEVICE_PARAMS_W {
  SP_CLASSINSTALL_HEADER ClassInstallHeader;
  WCHAR                  Title[MAX_TITLE_LEN];
  WCHAR                  Instructions[MAX_INSTRUCTION_LEN];
  WCHAR                  ListLabel[MAX_LABEL_LEN];
  WCHAR                  SubTitle[MAX_SUBTITLE_LEN];
} SP_SELECTDEVICE_PARAMS_W, *PSP_SELECTDEVICE_PARAMS_W;

メンバー

ClassInstallHeader

要求のヘッダー サイズと DIF コードを含むインストール要求ヘッダー。 「SP_CLASSINSTALL_HEADER」を参照してください。

Title[MAX_TITLE_LEN]

ドライバー選択ウィンドウのインストーラーによって提供されるウィンドウ タイトルを含むバッファー。 Windows では、[デバイスの選択] ダイアログのウィンドウ タイトルにこのタイトルが使用されます。

Instructions[MAX_INSTRUCTION_LEN]

インストーラーによって提供される select-device 命令を含むバッファー。

ListLabel[MAX_LABEL_LEN]

ユーザーが選択できるドライバーの一覧のインストーラーによって提供されるラベルを含むバッファー。

SubTitle[MAX_SUBTITLE_LEN]

デバイスの選択ウィザードで使用されるインストーラーによって提供されるサブタイトルを含むバッファー。 この文字列は、選択ダイアログでは使用されません。

注釈

インストーラーがドライバーの選択時に使用するこの構造体のフィールドを設定する場合、インストーラーは、SP_DEVINSTALL_PARAMSでDI_USECI_SELECTSTRINGS フラグも設定する必要があります。

次のスクリーン ショットは、サンプルの [デバイスの選択] ダイアログ ボックスを示し、インストーラーが指定できる文字列を識別します。

注意

setupapi.h ヘッダーは、unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとしてSP_SELECTDEVICE_PARAMSを定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件	値
Header	setupapi.h (Setupapi.h を含む)

こちらもご覧ください

DIF_SELECTDEVICE

SP_CLASSINSTALL_HEADER

SetupDiCallClassInstaller

SetupDiSelectDevice