IPnpCallbackHardware2::OnPrepareHardware 메서드(wudfddi.h)
[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에 새 기능이 추가되지 않으며 최신 버전의 Windows 10 UMDF 1에 대한 지원이 제한됩니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF를 사용하여 시작 참조하세요.]
OnPrepareHardware 메서드는 드라이버에서 디바이스에 액세스할 수 있도록 하는 데 필요한 모든 작업을 수행합니다.
구문
HRESULT OnPrepareHardware(
[in] IWDFDevice3 *pWdfDevice,
[in] IWDFCmResourceList *pWdfResourcesRaw,
[in] IWDFCmResourceList *pWdfResourcesTranslated
);
매개 변수
[in] pWdfDevice
프레임워크 디바이스 개체에 대한 IWDFDevice3 인터페이스에 대한 포인터입니다.
[in] pWdfResourcesRaw
플러그 앤 플레이 관리자가 디바이스에 할당한 원시 하드웨어 리소스를 식별하는 프레임워크 resource-list 개체에 대한 IWDFCmResourceList 인터페이스에 대한 포인터입니다.
[in] pWdfResourcesTranslated
플러그 앤 플레이 관리자가 디바이스에 할당한 변환된 하드웨어 리소스를 식별하는 프레임워크 resource-list 개체에 대한 IWDFCmResourceList 인터페이스에 대한 포인터입니다.
반환 값
OnPrepareHardware 는 작업이 성공하면 S_OK 반환합니다. 그렇지 않으면 이 메서드는 Winerror.h에 정의된 오류 코드 중 하나를 반환합니다. HRESULT_FROM_NT(STATUS_NOT_SUPPORTED)을 반환하지 마세요.
OnPrepareHardware가 오류 코드를 반환하는 경우 프레임워크는 여전히 IPnpCallbackHardware2::OnReleaseHardware 메서드를 호출합니다. OnReleaseHardware 메서드는 OnPrepareHardware를 호출하는 동안 할당된 리소스를 해제할 수 있습니다. OnReleaseHardware는 OnPrepareHardware의 성공 및 실패 사례 모두에 대해 리소스를 해제해야 하므로 OnReleaseHardware는 부분 리소스 정리를 처리할 수 있어야 합니다.
설명
IPnpCallbackHardware2::OnPrepareHardware 메서드는 원시 및 번역된 리소스를 수신한다는 점에서 IPnpCallbackHardware::OnPrepareHardware 메서드와 다릅니다.
하드웨어 리소스 구문 분석에 대한 자세한 내용은 UMDF 드라이버에서 하드웨어 리소스 찾기 및 매핑을 참조하세요.
예제
IWDFDevice3::MapIoSpace의 예제 코드를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원 종료 | UMDF 2.0 이상에서는 사용할 수 없습니다. |
| 대상 플랫폼 | 데스크톱 |
| 최소 UMDF 버전 | 1.11 |
| 머리글 | wudfddi.h |