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

아티클
03/05/2024

IWiaMiniDrv::d rvInitializeWia 메서드는 미니드라이버를 초기화하고 디바이스를 나타내는 드라이버 항목 트리를 빌드합니다.

구문

HRESULT drvInitializeWia(
  BYTE        *__MIDL__IWiaMiniDrv0000,
  LONG        __MIDL__IWiaMiniDrv0001,
  BSTR        __MIDL__IWiaMiniDrv0002,
  BSTR        __MIDL__IWiaMiniDrv0003,
  IUnknown    *__MIDL__IWiaMiniDrv0004,
  IUnknown    *__MIDL__IWiaMiniDrv0005,
  IWiaDrvItem **__MIDL__IWiaMiniDrv0006,
  IUnknown    **__MIDL__IWiaMiniDrv0007,
  LONG        *__MIDL__IWiaMiniDrv0008
);

매개 변수

__MIDL__IWiaMiniDrv0000

bstrDeviceID [in]

디바이스의 고유 식별자를 포함하는 문자열을 지정합니다.

__MIDL__IWiaMiniDrv0001

bstrRootFullItemName [in]

루트 항목의 전체 이름을 포함하는 문자열을 지정합니다.

__MIDL__IWiaMiniDrv0002

lFlags [in]

예약되어 있습니다. 0으로 설정됩니다.

__MIDL__IWiaMiniDrv0003

pIUnknownOuter [in, optional]

(선택 사항) IUnknown 인터페이스의 주소를 받을 수 있는 메모리 위치를 가리킵니다.

__MIDL__IWiaMiniDrv0004

pStiDevice [in, optional]

IStiDevice COM 인터페이스를 가리킵니다.

__MIDL__IWiaMiniDrv0005

pWiasContext [in]

WIA 항목 컨텍스트에 대한 포인터입니다.

__MIDL__IWiaMiniDrv0006

plDevErrVal [out]

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

__MIDL__IWiaMiniDrv0007

ppIDrvItemRoot [out, optional]

루트 항목의 인터페이스인 IWiaDrvItem 인터페이스의 주소를 받을 메모리 위치를 가리킵니다.

__MIDL__IWiaMiniDrv0008

ppIUnknownInner [out, optional]

(선택 사항) IUnknown 인터페이스의 주소를 받을 수 있는 메모리 위치를 가리킵니다. 미니 드라이버에 IWiaMiniDrv 인터페이스를 통해 액세스할 수 없는 기능이 있는 경우 공급업체는 미니드라이버에 별도의 인터페이스를 만들 수 있습니다. 이 매개 변수는 해당 기능에 대한 액세스를 제공합니다.

반환 값

성공하면 메서드는 S_OK 반환하고 plDevErrVal이 가리키는 디바이스 오류 값을 지워야 합니다. 메서드가 실패하면 표준 COM 오류 코드를 반환하고 plDevErrVal이 가리키는 메모리에 미니드라이버 관련 오류 코드 값을 배치해야 합니다.

plDevErrVal이 가리키는 값은 IWiaMiniDrv::d rvGetDeviceErrorStr를 호출하여 문자열로 변환할 수 있습니다.

설명

이 메서드는 모든 프라이빗 구조를 초기화하고 드라이버 항목 트리를 만들어야 합니다. 이 메서드에서 미니드라이버가 일반적으로 수행하는 단계에 대한 자세한 내용은 WIA 미니드라이버 초기화 및 WIA 드라이버 항목 트리 만들기를 참조하세요.

WIA 서비스는 CreateDevice 함수에 대한 클라이언트 호출에 대한 응답으로 IWiaMiniDrv::d rvInitializeWia 메서드를 호출합니다. 즉, 이 메서드는 각 새 클라이언트 연결에 대해 한 번씩 호출됩니다.

예를 들어 사용자가 내 컴퓨터에서 WIA 스캐너 아이콘을 마우스 오른쪽 단추로 클릭하면 셸에서 CreateDevice를 호출하여 미니드라이버의 IWiaMiniDrv::d rvInitializeWia 메서드에 대한 호출을 생성합니다. 그런 다음 사용자가 WIA 취득 마법사를 실행하는 경우 CreateDevice를 호출합니다. CreateDevice가 호출 될 때마다 미니 드라이버에서 IWiaMiniDrv::d rvInitializeWia 메서드에 대한 해당 호출이 있습니다.