SP_CLASSINSTALL_HEADER 구조체(setupapi.h)

아티클
03/05/2024

SP_CLASSINSTALL_HEADER 클래스 설치 매개 변수 구조의 첫 번째 멤버입니다. 여기에는 나머지 설치 매개 변수 구조의 형식을 정의하는 디바이스 설치 요청 코드가 포함되어 있습니다.

구문

typedef struct _SP_CLASSINSTALL_HEADER {
  DWORD       cbSize;
  DI_FUNCTION InstallFunction;
} SP_CLASSINSTALL_HEADER, *PSP_CLASSINSTALL_HEADER;

멤버

cbSize

SP_CLASSINSTALL_HEADER 구조체의 크기(바이트)입니다.

InstallFunction

클래스 설치 매개 변수 구조에 대한 DIF 코드(디바이스 설치 요청)입니다.

DIF 코드는 DIF_XXX 형식을 가지며 Setupapi.h에 정의되어 있습니다. DIF 코드에 대한 전체 설명 은 디바이스 설치 함수 코드를 참조하세요.

설명

구성 요소가 클래스 설치 매개 변수 구조를 할당하는 경우 일반적으로 구조체의 헤더 필드를 초기화합니다. 이러한 구성 요소는 InstallFunction 멤버를 설치 요청에 대한 DIF 코드로 설정하고 cbSize 를 SP_CLASSINSTALL_HEADER 구조체의 크기로 설정합니다. 예를 들면 다음과 같습니다.

SP_REMOVEDEVICE_PARAMS RemoveDeviceParams;
RemoveDeviceParams.ClassInstallHeader.cbSize = sizeof(SP_CLASSINSTALL_HEADER);
RemoveDeviceParams.ClassInstallHeader.InstallFunction = DIF_REMOVE;

구성 요소는 클래스 설치 매개 변수 구조를 SetupDiSetClassInstallParams에 전달하기 전에 InstallFunction 멤버를 설정해야 합니다.

그러나 클래스 설치 매개 변수를 SetupDiGetClassInstallParams에 전달할 때 구성 요소는 이 필드를 설정할 필요가 없습니다. 이 함수는 호출자에게 다시 전달되는 구조체에서 InstallFunction 멤버를 설정합니다. InstallFunction을 현재 활성 디바이스 설치 요청에 대한 DIF_XXX 코드로 설정합니다.