피드백

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

  • 아티클
  • 읽는 데 2분 걸림

IWiaMiniDrv::d rvFreeDrvItemContext 메서드는 디바이스별 컨텍스트를 해제합니다.

구문

HRESULT drvFreeDrvItemContext(
  LONG __MIDL__IWiaMiniDrv0056,
  BYTE *__MIDL__IWiaMiniDrv0057,
  LONG *__MIDL__IWiaMiniDrv0058
);

매개 변수

__MIDL__IWiaMiniDrv0056

lFlags [in]

예약되어 있습니다.

__MIDL__IWiaMiniDrv0057

pSpecContext [in]

디바이스별 컨텍스트를 가리킵니다.

__MIDL__IWiaMiniDrv0058

plDevErrVal [out]

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

반환 값

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

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

설명

드라이버 항목이 삭제되면 WIA 서비스는 드라이버 항목 컨텍스트를 해제합니다. 이 메서드는 컨텍스트를 해제할 준비가 되었다는 것을 미니 드라이버에 알릴 수 있습니다. 미니 드라이버는 컨텍스트에 할당된 모든 메모리를 해제해야 합니다. 예를 들어 IWiaMiniDrv::d rvReadItemProperties에서 카메라 미니 드라이버는 캐시를 할당하여 항목의 썸네일을 저장하고 드라이버 항목 컨텍스트에 이 캐시에 대한 포인터를 저장할 수 있습니다. 그런 다음 미니 드라이버는 이 메서드의 캐시를 해제합니다.

요구 사항

   
대상 플랫폼 데스크톱
헤더 wiamindr_lh.h(Wiamindr.h 포함)

참고 항목

IWiaMiniDrv

IWiaMiniDrv::d rvGetDeviceErrorStr

IWiaMiniDrv::d rvReadItemProperties