SP_SELECTDEVICE_PARAMS_W構造体 (setupapi.h)

[アーティクル]
03/01/2024

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 ではないコードと混在すると、コンパイルエラーまたはランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。