예: DownloadPreviewImage

DownloadPreviewImage 함수는 미리 보기 구성 요소의 IWiaPreview::GetNewPreview 메서드를 호출하여 스캐너에서 이미지 데이터를 다운로드합니다. 그런 다음, 애플리케이션 사용자가 감지하는 각 지역에 대해 pWiaItem2 아래에 자식 항목을 만드는 구분 필터를 호출하려는 경우 DetectSubregions 함수를 호출합니다. 이 예제에서 사용되는 DetectSubregions에 대한 자세한 내용은 IWiaSegmentationFilter::D etectRegions 메서드를 참조하세요.

이 예제에서 애플리케이션 사용자는 검사 상자를 클릭하여 m_bUseSegmentationFilter 매개 변수를 설정합니다. 애플리케이션에서 이를 지원하는 경우 먼저 IWiaItem2::CheckExtension을 호출하여 드라이버에 세분화 필터가 있는지 검사 합니다. 이 예제에서 사용되는 CheckImgFilter에 대한 자세한 내용은 Microsoft Windows SDK 설명서의 IWiaPreview::GetNewPreview 메서드를 참조하세요.

HRESULT
DownloadPreviewImage(
  IN IWiaItem2 *pWiaFlatbedItem2)
{
  HRESULT              hr = S_OK;
  BOOL                 bHasImgFilter  = FALSE;
  IWiaTransferCallback *pAppWiaTransferCallback = NULL;

  hr = CheckImgFilter(pWiaFlatbedItem2, &bHasImgFilter)

  if (SUCCEEDED(hr))
  {
     if (bHasImgFilter)
     {
        IWiaPreview *pWiaPreview = NULL;

        // In this example, the AppWiaTransferCallback class 
        // implements the IWiaTransferCallback interface.
         // The constructor of AppWiaTransferCallback sets the 
         // reference count to 1.
         pAppWiaTransferCallback = new AppWiaTransferCallback();

         hr = pAppWiaTransferCallback ? S_OK : E_OUTOFMEMORY;

         if (SUCCEEDED(hr))
         {
            // Acquire image from scanner
            hr = m_pWiaPreview->GetNewPreview(pWiaFlatbedItem2,
                                              0,
                                              pAppWiaTransferCallback);    
         }

         // m_FlatbedPreviewStream is the stream that
         // AppWiaTransferCallback::GetNextStream returned for the
         // flatbed item.
         // This stream is where the image data is stored after
         // the successful return of GetNewPreview.
         // The stream is passed into the segmentation filter
         // for region detection.
         if (SUCCEEDED(hr) && m_bUseSegmentationFilter)
         {
            DetectSubregions(m_FlatbedPreviewStream, pWiaFlatbedItem2);
         }

         if (pAppWiaTransferCallback)
         {
            // If the call to GetNewPreview was successful, the
            // preview component calls AddRef on the callback so
            // this call doesn't delete the object.

            pAppWiaTransferCallback->Release();
         }

      }
      else
      {
         // Do not create an instance of preview component if the 
         // driver does not come with an image-processing filter.
         // You can use a segmentation filter, however, if the driver
         // comes with one (omitted here).
      }
   }

   return hr;
}