Metodo IWiaImageFilter::InitializeFilter (wia_lh.h)

Articolo
02/29/2024

Il metodo IWiaImageFilter::InitializeFilter archivia i riferimenti ai parametri pWiaItem2 e pWiaTransferCallback passati al metodo .

Sintassi

HRESULT InitializeFilter(
  [in] IWiaItem2            *pWiaItem2,
  [in] IWiaTransferCallback *pWiaTransferCallback
);

Parametri

[in] pWiaItem2

Punta all'elemento IWiaItem2 per cui l'acquisizione dell'immagine è stata avviata dall'applicazione. Nel caso di IWiaTransfer::D ownload, si tratta dell'elemento WIA da cui è stata ottenuta l'interfaccia IWiaTransfer e, nel caso del componente Preview, è l'elemento passato al metodo IWiaPreview::GetNewPreview .

[in] pWiaTransferCallback

Punta a un'interfaccia IWiaTransferCallback . L'interfaccia IWiaTransferCallback è l'interfaccia di callback dell'applicazione, che viene passata a IWiaTransfer::D ownload e IWiaPreview::GetNewPreview.

Valore restituito

Restituisce S_OK in caso di esito positivo o un codice di errore COM standard in caso di errore.

Commenti

Questo metodo viene chiamato dall'oggetto proxy COM prima che la chiamata di download raggiunga il servizio WIA. Ciò si verifica in due casi: quando un'applicazione chiama il metodo IWiaTransfer::D ownload e quando un'applicazione chiama il metodo IWiaPreview::GetNewPreview .

Tutto ciò che è necessario per IWiaImageFilter::InitializeFilter consiste nell'archiviare i riferimenti a pWiaItem2 e pWiaTransferCallback passati. Questi puntatori di interfaccia devono essere archiviati come variabili membro in questo metodo e AddRef deve essere chiamato per ogni puntatore all'interfaccia. Questi due puntatori di interfaccia sono necessari nell'implementazione del filtro dei metodi IWiaTransferCallback::TransferCallback e IWiaTransferCallback::GetNextStream .

Questo metodo non può essere richiamato direttamente dall'applicazione.