次の方法で共有

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]

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

Reserved[2]

引っ込み思案。 内部使用のみ。

備考

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

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

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

手記

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

必要条件

要件 価値
ヘッダー setupapi.h (Setupapi.h を含む)

関連項目

DIF_SELECTDEVICE

SP_CLASSINSTALL_HEADER

SetupDiCallClassInstaller の

SetupDiSelectDevice の