IWiaMiniDrv::d rvGetDeviceErrorStr 메서드(wiamindr_lh.h)

IWiaMiniDrv::d rvGetDeviceErrorStr 메서드는 오류를 설명하는 유니코드 문자열에 오류 코드를 매핑합니다.

구문

HRESULT drvGetDeviceErrorStr(
  LONG     __MIDL__IWiaMiniDrv0039,
  LONG     __MIDL__IWiaMiniDrv0040,
  LPOLESTR *__MIDL__IWiaMiniDrv0041,
  LONG     *__MIDL__IWiaMiniDrv0042
);

매개 변수

__MIDL__IWiaMiniDrv0039

lDevErrVal [in]

문자열에 매핑할 디바이스 오류 값을 지정합니다. 값이 0이면 오류가 발생하지 않음을 나타냅니다.

__MIDL__IWiaMiniDrv0040

lFlags [in]

예약되어 있습니다.

__MIDL__IWiaMiniDrv0041

plDevErr [out]

이 메서드에 대한 상태 코드를 받을 메모리 위치를 가리킵니다. 이 메서드가 S_OK 반환하면 저장된 값은 0이 됩니다. 그렇지 않으면 미니 드라이버 관련 오류 코드가 이 매개 변수가 가리키는 위치에 저장됩니다.

__MIDL__IWiaMiniDrv0042

ppszDevErrStr [out, optional]

오류를 설명하는 문자열의 주소를 받을 메모리 위치를 가리킵니다.

반환 값

성공하면 메서드는 S_OK 반환하고 plDevErr에서 가리키는 디바이스 오류 값을 지워야 합니다. 미니 드라이버가 이 메서드를 완전히 구현하지 않으면 메서드는 E_NOTIMPL 반환해야 합니다. 미니 드라이버가 이 메서드에 전달된 오류 값을 인식하지 못하는 경우 메서드는 E_INVALIDARG 반환해야 합니다. 메서드가 실패하면 표준 COM 오류 코드를 반환하고 plDevErr가 가리키는 메모리에 미니 드라이버 관련 오류 코드 값을 배치해야 합니다.

설명

디바이스별 미니드라이버 생성 오류 값을 설명하는 오류 문자열을 가져오기 위해 WIA 서비스는 IWiaMiniDrv::d rvGetDeviceErrorStr 메서드를 호출합니다. 이 호출에 대한 응답으로 미니 드라이버는 CoTaskMemAlloc 을 사용하여 미니 드라이버에 전달된 오류 코드에 해당하는 지역화된 유니코드 문자열을 포함하는 메모리를 할당해야 합니다. WIA 서비스(또는 애플리케이션)는 메모리를 해제합니다. 애플리케이션에서 문자열을 표시할 가능성이 있으므로 최종 사용자에게 의미가 있어야 합니다. 다양한 언어로 지역화할 수 있도록 리소스 파일에서 문자열을 로드해야 합니다.

요구 사항