Metodo IWiaPreview::D etectRegions

Richiama il filtro di segmentazione del driver e passa l'immagine non filtrata memorizzata nella cache dal metodo IWiaPreview::GetNewPreview al filtro.

Sintassi

HRESULT DetectRegions(
  [in] LONG lFlags
);

Parametri

lFlags [in]

Tipo: LONG

Non usato. Impostare su zero (0).

Valore restituito

Tipo: HRESULT

Questo metodo può restituire uno di questi valori.

Commenti

Un'applicazione deve chiamare IWiaPreview::GetNewPreview prima di chiamare questa funzione.

Quando windows Image Acquisition (WIA) 2.0 Preview Component chiama IWiaPreview::D etectRegions, richiama il filtro di segmentazione driver e passa l'interfaccia IWiaItem2 passata in precedenza a IWiaPreview::GetNewPreview. Passa anche l'immagine memorizzata nella cache interna al filtro. Il filtro di segmentazione usa l'immagine memorizzata nella cache per creare gli extent figlio.

Se un'applicazione modifica le proprietà dell'interfaccia IWiaItem2 dopo che chiama IWiaPreview::GetNewPreview, le proprietà originali devono essere ripristinate prima che l'applicazione chiami IWiaPreview::D etectRegions. Usare GetPropertyStream e SetPropertyStream per ripristinare le proprietà originali.

IWiaPreview::D etectRegions viene usato per determinare le "aree secondarie" dell'immagine memorizzata nella cache. Per ogni area secondaria rilevata, viene creato un nuovo elemento WIA 2.0 figlio nell'interfaccia IWiaItem2 . Per ogni elemento figlio, il filtro di segmentazione deve impostare i valori per le proprietà WIA 2.0 seguenti: WIA_IPS_XPOS, WIA_IPS_YPOS, WIA_IPS_XEXTENT e WIA_IPS_YEXTENT. Un filtro più avanzato imposta altre proprietà WIA 2.0, ad esempio WIA_IPS_DESKEW_X e WIA_IPS_DESKEW_Y, se il driver supporta l'asimmetria. Le proprietà WIA_IPS_XPOS, WIA_IPS_YPOS, WIA_IPS_XEXTENT e WIA_IPS_YEXTENT rappresentano il rettangolo di selezione dell'area da analizzare.

Il driver potrebbe non supportare la segmentazione. Prima di chiamare IWiaPreview::D etectRegions, un'applicazione verifica in genere se il driver supporta la proprietà WIA_IPS_SEGMENTATION. Se la proprietà non è implementata, la segmentazione non è supportata e IWiaPreview::D etectRegions ha esito negativo e restituisce E_NOTIMPL.

L'applicazione deve pulire gli elementi figlio creati chiamando IWiaPreview::D etectRegions. Ad esempio, se un'applicazione effettua una chiamata aggiuntiva a IWiaPreview::D etectRegions nello stesso elemento, deve pulire gli elementi figlio precedenti.

Requisiti