Método IWiaImageFilter::InitializeFilter (wia_lh.h)
El método IWiaImageFilter::InitializeFilter almacena las referencias a los parámetros pWiaItem2 y pWiaTransferCallback pasados al método .
Sintaxis
HRESULT InitializeFilter(
[in] IWiaItem2 *pWiaItem2,
[in] IWiaTransferCallback *pWiaTransferCallback
);
Parámetros
[in] pWiaItem2
Apunta al elemento IWiaItem2 para el que la aplicación inició la adquisición de la imagen. En el caso de IWiaTransfer::D ownload, es el elemento WIA del que obtuvimos la interfaz IWiaTransfer y, en el caso del componente Preview, es el elemento que pasamos al método IWiaPreview::GetNewPreview .
[in] pWiaTransferCallback
Apunta a una interfaz IWiaTransferCallback . La interfaz IWiaTransferCallback es la interfaz de devolución de llamada de la aplicación, que se pasa a IWiaTransfer::D ownload e IWiaPreview::GetNewPreview.
Valor devuelto
Devuelve S_OK si se ejecuta correctamente o un código de error COM estándar en caso de error.
Comentarios
El objeto proxy COM llama a este método antes de que la llamada de descarga llegue al servicio WIA. Esto sucede en dos casos: cuando una aplicación llama al método IWiaTransfer::D ownload y cuando una aplicación llama al método IWiaPreview::GetNewPreview .
Todo lo que se requiere IWiaImageFilter::InitializeFilter es almacenar las referencias a pWiaItem2 y pWiaTransferCallback que se le pasan. Estos punteros de interfaz deben almacenarse como variables miembro en este método y se debe llamar a AddRef para cada puntero de interfaz. Estos dos punteros de interfaz son necesarios en la implementación del filtro de los métodos IWiaTransferCallback::TransferCallback e IWiaTransferCallback::GetNextStream .
La aplicación no puede invocar este método directamente.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | wia_lh.h (incluya Wia_lh.h) |