Metodo IWiaImageFilter::InitializeFilter (wia_lh.h)

Articolo
02/07/2025

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

Sintassi

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

Parametri

[in] pWiaItem2

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

[in] pWiaTransferCallback

Punta a un'interfacciaIWiaTransferCallback. L'interfaccia IWiaTransferCallback è l'interfaccia di callback dell'applicazione, 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.

Osservazioni

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 metodo IWiaTransfer::D ownload e quando un'applicazione chiama il metodo IWiaPreview::GetNewPreview.

È necessario IWiaImageFilter::InitializeFilter per archiviare i riferimenti a pWiaItem2 e pWiaTransferCallback passati. Questi puntatori di interfaccia devono essere archiviati come variabili membro in questo metodo e è necessario chiamare addRef per ogni puntatore di interfaccia. Questi due puntatori di interfaccia sono necessari nell'implementazione del filtro dei metodi di IWiaTransferCallback::TransferCallback e IWiaTransferCallback::GetNextStream.

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