共用方式為

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]

緩衝區，其中包含安裝程式提供的選取裝置指示。

ListLabel[MAX_LABEL_LEN]

緩衝區，其中包含安裝程式提供的標籤，供使用者可以從中選取的驅動程式清單。

SubTitle[MAX_SUBTITLE_LEN]

緩衝區，其中包含選取裝置精靈中使用的安裝程式提供的副標題。 此字串不會用於選取對話框中。

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