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]

select-device 마법사에서 사용되는 설치 관리자 제공 자막을 포함하는 버퍼입니다. 이 문자열은 선택 대화 상자에서 사용되지 않습니다.

설명

설치 관리자가 드라이버 선택 중에 사용할 이 구조의 필드를 설정하는 경우 설치 관리자는 SP_DEVINSTALL_PARAMS DI_USECI_SELECTSTRINGS 플래그도 설정해야 합니다.

다음 스크린샷은 샘플 디바이스 선택 대화 상자를 보여 줍니다. 설치 관리자가 제공할 수 있는 문자열을 식별합니다.

참고

setupapi.h 헤더는 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 SP_SELECTDEVICE_PARAMS 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.