다음을 통해 공유


SP_DETECTDEVICE_PARAMS 구조체(setupapi.h)

SP_DETECTDEVICE_PARAMS 구조체는 DIF_DETECT 설치 요청에 해당합니다.

구문

typedef struct _SP_DETECTDEVICE_PARAMS {
  SP_CLASSINSTALL_HEADER  ClassInstallHeader;
  PDETECT_PROGRESS_NOTIFY DetectProgressNotify;
  PVOID                   ProgressNotifyParam;
} SP_DETECTDEVICE_PARAMS, *PSP_DETECTDEVICE_PARAMS;

멤버

ClassInstallHeader

요청에 대한 헤더 및 DIF 코드의 크기를 포함하는 설치 요청 헤더입니다. SP_CLASSINSTALL_HEADER 참조하세요.

DetectProgressNotify

디바이스 검색 작업에 대한 진행률 표시줄을 표시하는 콜백 루틴입니다. 콜백 루틴은 DIF_DETECT 요청을 보내는 디바이스 설치 구성 요소에서 제공합니다. 콜백에는 다음과 같은 프로토타입이 있습니다.

typedef BOOL (CALLBACK* PDETECT_PROGRESS_NOTIFY)(
    IN PVOID ProgressNotifyParam,
    IN DWORD DetectComplete
    );

ProgressNotifyParam 은 검색 작업을 식별하는 불투명한 "핸들"입니다. 이 값은 DIF_DETECT 요청을 보낸 디바이스 설치 구성 요소 에서 제공합니다.

DetectComplete 는 완료율 백분율을 나타내는 0에서 100 사이의 값입니다. 클래스 설치 관리자는 검색 활동의 다양한 단계에서 이 값을 증가하여 사용자에게 진행 상황을 알립니다.

ProgressNotifyParam

클래스 설치 관리자가 진행률 콜백 루틴에 전달하는 불투명 ProgressNotifyParam "handle"입니다.

요구 사항

요구 사항
헤더 setupapi.h(Setupapi.h 포함)

추가 정보

DIF_DETECT

SP_CLASSINSTALL_HEADER

SetupDiCallClassInstaller