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
플러그 앤 플레이 관리자가 디바이스에 할당한 원시 하드웨어 리소스를 식별하는 프레임워크 리소스 목록 개체의 IWDFCmResourceList 인터페이스에 대한 포인터입니다.
[in] pWdfResourcesTranslated
플러그 앤 플레이 관리자가 디바이스에 할당한 변환된 하드웨어 리소스를 식별하는 프레임워크 리소스 목록 개체의 IWDFCmResourceList 인터페이스에 대한 포인터입니다.
반환 값
OnPrepareHardware 작업이 성공하면 S_OK 반환합니다. 그렇지 않으면 이 메서드는 Winerror.h에 정의된 오류 코드 중 하나를 반환합니다. HRESULT_FROM_NT(STATUS_NOT_SUPPORTED)를 반환하지 마세요.
OnPrepareHardware 오류 코드를 반환하는 경우 프레임워크는 여전히 IPnpCallbackHardware2::OnReleaseHardware 메서드를 호출합니다. OnReleaseHardware 메서드는 OnPrepareHardware호출하는 동안 할당된 리소스를 해제할 수 있습니다. OnReleaseHardwareOnPrepareHardware성공 및 실패 사례 모두에 대해 리소스를 해제해야 하므로 OnReleaseHardware 부분 리소스 정리를 처리할 수 있어야 합니다.
발언
IPnpCallbackHardware2::OnPrepareHardware 메서드는 원시 및 번역된 리소스를 수신한다는 점에서 IPnpCallbackHardware::OnPrepareHardware 메서드와 다릅니다.
하드웨어 리소스 구문 분석에 대한 자세한 내용은 UMDF 드라이버하드웨어 리소스 찾기 및 매핑을 참조하세요.
예제
IWDFDevice3::MapIoSpace예제 코드를 참조하세요.
요구 사항
| 요구 | 값 |
|---|---|
| 지원 종료 | UMDF 2.0 이상에서는 사용할 수 없습니다. |
| 대상 플랫폼 | 바탕 화면 |
| 최소 UMDF 버전 | 1.11 |
| 헤더 | wudfddi.h |