SP_SELECTDEVICE_PARAMS_A 構造体 (setupapi.h)

  • [アーティクル]

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

構文

typedef struct _SP_SELECTDEVICE_PARAMS_A {
  SP_CLASSINSTALL_HEADER ClassInstallHeader;
  CHAR                   Title[MAX_TITLE_LEN];
  CHAR                   Instructions[MAX_INSTRUCTION_LEN];
  CHAR                   ListLabel[MAX_LABEL_LEN];
  CHAR                   SubTitle[MAX_SUBTITLE_LEN];
  BYTE                   Reserved[2];
} SP_SELECTDEVICE_PARAMS_A, *PSP_SELECTDEVICE_PARAMS_A;

メンバー

ClassInstallHeader

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

Title[MAX_TITLE_LEN]

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

Instructions[MAX_INSTRUCTION_LEN]

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

ListLabel[MAX_LABEL_LEN]

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

SubTitle[MAX_SUBTITLE_LEN]

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

Reserved[2]

予約済み。 内部使用専用です。

注釈

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

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

[デバイス ドライバーの選択] ダイアログ ボックスのスクリーン ショット

注意

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

要件

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

こちらもご覧ください

DIF_SELECTDEVICE

SP_CLASSINSTALL_HEADER

SetupDiCallClassInstaller

SetupDiSelectDevice