Metodo IWiaSegmentationFilter::D etectRegions (wia_lh.h)
Il metodo IWiaSegmentationFilter::D etectRegions determina le sottoregioni di un'immagine disposta sul piatto piatto in modo che ogni sottorezione possa essere acquisita in un elemento immagine separato.
Sintassi
HRESULT DetectRegions(
[in] LONG lFlags,
[in, optional] IStream *pInputStream,
[in, optional] IWiaItem2 *pWiaItem2
);
Parametri
[in] lFlags
Attualmente inutilizzato. Deve essere impostato su zero.
[in, optional] pInputStream
Specifica un puntatore all'immagine di anteprima IStream .
[in, optional] pWiaItem2
Specifica un puntatore all'elemento IWiaItem2 per il quale è stato acquisito pInputStream . Il filtro di segmentazione crea elementi figlio per questo elemento.
Valore restituito
Restituisce S_OK in caso di esito positivo o un valore di errore COM standard in caso contrario.
Commenti
Questo metodo determina le sottoregioni dell'immagine rappresentata da pInputStream. Per ogni sottoarea rilevata, crea un elemento figlio per l'elemento IWiaItem2] a cui punta il parametro pWiaItem2 . Per ogni elemento figlio, il filtro di segmentazione deve impostare i valori per il rettangolo di delimitazione dell'area da analizzare, utilizzando le proprietà degli elementi dello scanner WIA seguenti:
Un filtro più avanzato potrebbe richiedere anche altre proprietà degli elementi dello scanner, ad esempio WIA_IPS_DESKEW_X e WIA_IPS_DESKEW_Y, se il driver supporta deskewing.
Se un'applicazione chiama IWiaSegmentationFilter::D etectRegions più volte, l'applicazione deve prima eliminare gli elementi figlio creati dall'ultima chiamata al metodo IWiaSegmentationFilter::D etectRegions .
Se un'applicazione modifica le proprietà in pWiaItem2, tra l'acquisizione dell'immagine in pInputStream e la relativa chiamata a IWiaSegmentationFilter::D etectRegions, è necessario ripristinare le impostazioni delle proprietà originali (le impostazioni delle proprietà dell'elemento erano state acquisite al momento dell'acquisizione del flusso). Questa operazione può essere eseguita usando IWiaPropertyStorage::GetPropertyStream e IWiaPropertyStorage::SetPropertyStream.
L'applicazione deve reimpostare l'anteprima di IStream se la chiamata passa lo stesso flusso al filtro di segmentazione più volte. L'applicazione deve anche reimpostare il flusso dopo il download iniziale e prima di chiamare IWiaSegmentationFilter::D etectRegions.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | wia_lh.h (includere Wia_lh.h) |