Device-Specific 공동 설치 관리자 등록

참고

이 섹션에 설명된 기능은 범용 또는 모바일 드라이버 패키지에서 지원되지 않습니다. 유니버설 INF 파일 사용을 참조하세요.

디바이스별 공동 설치 관리자를 등록하려면 디바이스의 INF 파일에 다음 섹션을 추가합니다.

;  :
;  :
[DestinationDirs]
XxxCopyFilesSection = 11                \\DIRID_SYSTEM
                                        \\ Xxx = driver or dev. prefix
;  :
;  :
[XxxInstall.OS-platform.CoInstallers]   \\ OS-platform is optional
CopyFiles = XxxCopyFilesSection
AddReg = Xxx.OS-platform.CoInstallers_AddReg
 
[XxxCopyFilesSection]
XxxCoInstall.dll
 
[Xxx.OS-platform.CoInstallers_AddReg]
HKR,,CoInstallers32,0x00010000,"XxxCoInstall.dll, \
 XxxCoInstallEntryPoint"

DestinationDirs 섹션의 항목은 XxxCopyFilesSection에 나열된 파일이 시스템 디렉터리에 복사되도록 지정합니다. Xxx 접두사는 드라이버, 디바이스 또는 디바이스 그룹(예cdrom_CopyFilesSection: )에 대한 고유 식별자여야 합니다.

위의 예제 XxxInstall.OS-platform.CoInstallers에서 다음 섹션은 DDInstall입니다. CoInstallers 섹션. 이 섹션의 이름에는 선택적 OS/아키텍처 확장(예: cdrom_install.NTx86.CoInstallers)이 있을 수 있습니다. 라는 file-list-section을 지정하는 CopyFiles 지시문과 라는 XxxCopyFilesSectionXxx.OS-platform.CoInstallers_AddReg추가 레지스트리 섹션을 지정하는 AddReg 지시문이 포함되어 있습니다.

추가 레지스트리 섹션의 항목은 디바이스의 드라이버 키에 CoInstallers32 값 항목을 만듭니다. 항목에는 공동 설치 관리자 DLL 및 선택적으로 특정 진입점이 포함됩니다. 진입점을 생략하면 기본값은 CoDeviceInstall입니다. 16진수 플래그 매개 변수(0x00010000)는 REG_MULTI_SZ 값 항목 임을 지정합니다.

디바이스에 대해 둘 이상의 디바이스별 공동 설치 관리자를 등록하려면 각 공동 설치 관리자에 대한 파일을 복사하고 레지스트리 항목에 둘 이상의 문자열을 포함합니다. 예를 들어 두 개의 공동 설치 관리자를 등록하려면 다음과 같은 INF 섹션을 만듭니다.

;   :
;   :
[DestinationDirs]
XxxCopyFilesSection = 11                \\DIRID_SYSTEM
                                        \\ Xxx = driver or dev. prefix
;   :
;   :
[XxxInstall.OS-platform.CoInstallers]   \\ OS-platform is optional
CopyFiles = XxxCopyFilesSection
AddReg = Xxx.OS-platform.CoInstallers_AddReg
 
[XxxCopyFilesSection]
XxxCoInstall.dll                         \\ copy 1st coinst. file
YyyCoInstall.dll                         \\ copy 2nd coinst. file
 
[Xxx.OS-platform.CoInstallers_AddReg]
HKR,,CoInstallers32,0x00010000,                 \
    "XxxCoInstall.dll, XxxCoInstallEntryPoint", \
    "YyyCoInstall.dll, YyyCoInstallEntryPoint"
                                         \\ add both to registry

디바이스별 공동 설치 관리자는 Coinstallers INF 섹션이 처리될 때 디바이스를 설치하는 동안 등록됩니다. 그런 다음 SetupAPI 는 설치 프로세스의 각 후속 단계에서 공동 설치 관리자를 호출합니다. 디바이스에 대해 둘 이상의 공동 설치 관리자가 등록된 경우 SetupAPI는 레지스트리에 나열된 순서대로 호출합니다.