Пример. Фильтр сегментации по умолчанию

Драйверу не требуется иметь собственный фильтр сегментации, чтобы воспользоваться преимуществами фильтра сегментации Майкрософт, если он реализует свойство WIA_IPS_SEGMENTATION. Кроме того, IHV может предоставить собственный фильтр сегментации, который в определенных обстоятельствах вызывает фильтр сегментации WIA майкрософт по умолчанию. Например, IHV может захотеть предоставить фильтр сегментации для конкретного устройства для обнаружения в нескольких регионах во время сканирования пленки и использовать фильтр сегментации, предоставленный корпорацией Майкрософт во время сканирования из планшета. Для этого фильтру сегментации WIA IHV нужно создать только CLSID_WiaDefaultSegFilter, который реализует IWiaSegmentationFilter. Фильтр сегментации будет вызывать DetectRegions. В следующем примере кода показано, как это можно сделать.

STDMETHODIMP
SegFilter::DetectRegions(
   IN LONG       lFlags,
     IN IStream    *pInputStream,
     IN IWiaItem2  *pWiaItem2)
{
    HRESULT  hr                = S_OK;
    GUID     categoryGUID      = {0};
    BOOL     bUseDefaultFilter = FALSE;

    ...


    if (SUCCEEDED(hr))

    {
        ReadPropertyLong(pWiaItem2,
                         WIA_IPA_ITEM_CATEGORY,
                         &categoryGUID);
 
        if (categoryGUID == WIA_CATEGORY_FILM)
        {
            bUseDefaultFilter = FALSE;
        }
        else if (categoryGUID == WIA_CATEGORY_FLATBED)
        {
            bUseDefaultFilter = TRUE;
        }
        else
        {
            //
            // This scanner only comes with flatbed and film items.
            //
            hr = E_INVALIDARG;
        }
    }
 
    ...
 
    if (SUCCEEDED(hr) && bUseDefaultFilter)
    {
        //
        // This must be on the flatbed item - use the Microsoft Default WIA Segmentation Filter.
        //

        IWiaSegmentationFilter *pDefaultSegFilter = NULL;
 
        hr = CoCreateInstance(CLSID_WiaDefaultSegFilter,
                              NULL,
                              CLSCTX_INPROC_SERVER,
                              IID_IWiaSegmentationFilter,
                              reinterpret_cast<void **>(&pDefaultSegFilter));
        if (SUCCEEDED(hr))
        {
            hr = pDefaultSegFilter->DetectRegions(lFlags, pInputStream, pWiaItem2);
        }
 
        if (pDefaultSegFilter)
        {
            pDefaultSegFilter->Release();
            pDefaultSegFilter = NULL;
        }
    }
    else if (SUCCEEDED(hr))
    {
        //
        // This is on the film item - use the default WIA segmentation algorithm.
        //
        ...
    }
    ...
}