SetupDiGetActualModelsSectionA 함수(setupapi.h)

SetupDiGetActualModelsSection 함수는 디바이스 INF 파일에서 디바이스를 설치할 때 사용할 적절한 데코레이팅된 INF 모델 섹션을 검색합니다.

구문

WINSETUPAPI BOOL SetupDiGetActualModelsSectionA(
  [in]            PINFCONTEXT          Context,
  [in, optional]  PSP_ALTPLATFORM_INFO AlternatePlatformInfo,
  [out, optional] PSTR                 InfSectionWithExt,
  [in]            DWORD                InfSectionWithExtSize,
  [out, optional] PDWORD               RequiredSize,
                  PVOID                Reserved
);

매개 변수

[in] Context

INF 파일의 INF Manufacturer 섹션에서 제조업체 식별자 항목을 지정하는 INF 파일 컨텍스트에 대한 포인터입니다. manufacturer-identifier 항목은 INF 모델 섹션 이름을 지정하고 선택적으로 Models 섹션 이름에 대한 TargetOSVersion 장식을 지정합니다. INF 파일 및 INF 파일 컨텍스트에 대한 자세한 내용은 INF 파일 사용에 대한 플랫폼 SDK topics 및 INFCONTEXT 구조를 참조하세요.

[in, optional] AlternatePlatformInfo

Windows 버전 및 프로세서 아키텍처에 대한 정보를 제공하는 SP_ALTPLATFORM_INFO 구조체에 대한 포인터입니다. 이 구조체의 cbSize 멤버는 sizeof(SP_ALTPLATFORM_INFO_V2)로 설정해야 합니다. 이 매개 변수는 선택 사항이며 NULL로 설정할 수 있습니다.

[out, optional] InfSectionWithExt

데코레이팅된 INF Models 섹션 이름과 NULL 종결자가 포함된 문자열을 수신하는 버퍼에 대한 포인터입니다. AlternatePlatformInfo가 제공되지 않으면 데코레이팅된 INF 모델 섹션 이름이 현재 플랫폼에 적용됩니다. 그렇지 않으면 이름이 지정된 대체 플랫폼에 적용됩니다. 이 매개 변수는 선택 사항이며 NULL로 설정할 수 있습니다. 이 매개 변수가 NULL이면 함수는 TRUE를 반환하고 데코레이팅된 Models 섹션 이름과 종료 NULL 문자를 반환하는 데 필요한 크기(문자)로 RequiredSize를 설정합니다.

[in] InfSectionWithExtSize

DecoratedModelsSection 버퍼의 크기(문자)입니다. DecoratedModelsSection이 NULL이면 이 매개 변수를 0으로 설정해야 합니다.

[out, optional] RequiredSize

데코레이팅된 Models 섹션 이름과 종결 NULL 문자를 검색하는 데 필요한 DecoratedModelsSection 버퍼의 크기(문자)를 수신하는 DWORD 형식 변수에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL로 설정할 수 있습니다.

Reserved

내부 시스템 사용을 위해 예약되어 있습니다. 이 매개 변수는 NULL로 설정해야 합니다.

반환 값

작업이 성공하면 SetupDiGetActualModelsSection이 TRUE를 반환합니다. 그렇지 않으면 함수는 FALSE 를 반환하고 GetLastError를 호출하여 기록된 오류를 검색할 수 있습니다.

설명

SetupDiGetActualModelsSection은 AlternatePlatformInfo가 제공되지 않은 경우 현재 플랫폼에 적용되는 제조업체 식별자 항목(컨텍스트에서 제공됨)의 TargetOSVersion 필드 또는 대체 플랫폼 정보가 제공된 경우 대체 플랫폼에 적용되는 대상OSVersion 필드를 결정합니다. SetupDiGetActualModelsSection 은 모든 TargetOSVersion 필드를 기반으로 가장 적합한 플랫폼을 선택하고, TARGETOSVersion 문자열을 INF 모델 섹션 이름에 추가하고, 데코레이팅된 INF 모델 섹션 이름을 호출자에게 반환합니다. 제조업체 식별자 항목에서 운영 체제 주 버전은 OSMajorVersion 필드에 의해 지정되고 운영 체제 부 버전은 OSMinorVersion 필드에 의해 지정됩니다.

디바이스에 대한 INF DDInstall 섹션 을 검색하는 방법에 대한 자세한 내용은 SetupDiGetActualSectionToInstall을 참조하세요.

참고

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

요구 사항

지원되는 최소 클라이언트	Windows Server 2003 SP1(서비스 팩 1) 이상 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼	데스크톱
머리글	setupapi.h(Setupapi.h 포함)
라이브러리	Setupapi.lib

추가 정보

INF DDInstall 섹션

SP_ALTPLATFORM_INFO

SetupDiGetActualSectionToInstall