WdfPreDeviceInstall 함수(wdfinstaller.h)
[KMDF에만 적용]
공동 설치 관리자의 WdfPreDeviceInstall 함수는 PnP(비 플러그 앤 플레이) 드라이버 설치 관리자가 드라이버의 커널 모드 서비스를 만들기 전에 공동 설치 관리자에 필요할 수 있는 모든 작업을 수행합니다.
구문
ULONG WdfPreDeviceInstall(
[in] LPCWSTR InfPath,
[in, optional] LPCWSTR InfSectionName
);
매개 변수
[in] InfPath
드라이버의 INF 파일에 대한 디렉터리 경로를 포함하는 null로 끝나는 와이드 문자열에 대한 포인터입니다. 드라이버의 설치 관리자는 Microsoft Windows SDK 설명된 GetCurrentDirectory를 호출하여 이 문자열을 가져올 수 있습니다.
[in, optional] InfSectionName
드라이버의 INF 파일에 Wdf-install-section 이름이 포함된 null로 끝나는 와이드 문자열에 대한 포인터입니다. 이 이름에 대한 자세한 내용은 KMDF 공동 설치 관리자 사용을 참조하세요. 이 포인터가 NULL인 경우 공동 설치 관리자는 이름에 WdfSection 을 사용합니다.
반환 값
WdfPreDeviceInstall 은 작업이 성공하면 ERROR_SUCCESS 반환합니다. 그렇지 않으면 함수는 Winerror.h에 정의된 추가 ERROR_XXX 값 중 하나를 반환합니다.
설명
비 PnP 디바이스의 프레임워크 기반 드라이버에 대한 설치 관리자는 설치 관리자가 CreateService를 호출하기 전에 WdfPreDeviceInstall 또는 WdfPreDeviceInstallEx를 호출해야 합니다.
공동 설치 관리자의 WdfPreDeviceInstall 함수의 주소를 가져오려면 설치 관리자가 LoadLibrary를 호출하여 공동 설치 관리자를 로드한 후 설치 관리자가 GetProcAddress를 호출해야 합니다.
공동 설치 관리자가 드라이버 설치를 완료하기 위해 컴퓨터를 다시 시작해야 한다고 판단하는 경우(일반적으로 이전 버전의 프레임워크가 이전에 설치되었기 때문에) WdfPreDeviceInstall은 PnP(플러그 앤 플레이) 관리자에게 알릴 수 있습니다. 그러면 PnP 관리자가 사용자에게 다시 시작해야 한다는 메시지를 표시합니다.
비 PnP 디바이스의 프레임워크 기반 드라이버에 대한 WdfPreDeviceInstall 함수 및 설치 관리자에 대한 자세한 내용은 비 PnP 드라이버 설치를 참조하세요. CreateService, GetProcAddress 및 LoadLibrary에 대한 자세한 내용은 Microsoft Windows SDK 설명서를 참조하세요.
예제
WdfPreDeviceInstall 함수를 사용하는 코드 예제는 NONPNP 샘플의 설치 관리자를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 유니버설 |
| 최소 KMDF 버전 | 1.0 |
| 머리글 | wdfinstaller.h(Wdfinstaller.h 포함) |
| 라이브러리 | 해당 없음(KMDF 공동 설치 관리자 라이브러리에서 내보냅니다. 공동 설치 관리자 라이브러리의 파일 이름에 대한 자세한 내용은 KMDF 공동 설치 관리자 사용을 참조하세요.) |