Exemplo: Filtro de Segmentação Padrão

Um driver não precisa ter seu próprio filtro de segmentação para aproveitar o filtro de segmentação da Microsoft, desde que implemente a propriedade WIA_IPS_SEGMENTATION. Outra possibilidade é que um IHV forneça seu próprio filtro de segmentação, que durante determinadas circunstâncias chama o filtro de segmentação WIA padrão da Microsoft. Por exemplo, um IHV pode querer fornecer um filtro de segmentação muito específico do dispositivo para detecção de várias regiões durante a verificação de filme e usar o filtro de segmentação fornecido pela Microsoft durante as verificações do flatbed. Para fazer isso, um filtro de segmentação WIA IHV só precisa criar CLSID_WiaDefaultSegFilter, que implementa IWiaSegmentationFilter; o filtro de segmentação chamaria DetectRegions. O exemplo de código a seguir mostra como isso pode ser feito.

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.
        //
        ...
    }
    ...
}