Método IWiaMiniDrv::d rvInitializeWia (wiamindr_lh.h)

Artículo
02/27/2024

El método IWiaMiniDrv::d rvInitializeWia inicializa el minidriver y compila el árbol de elementos de controlador que representa el dispositivo.

Sintaxis

HRESULT drvInitializeWia(
  BYTE        *__MIDL__IWiaMiniDrv0000,
  LONG        __MIDL__IWiaMiniDrv0001,
  BSTR        __MIDL__IWiaMiniDrv0002,
  BSTR        __MIDL__IWiaMiniDrv0003,
  IUnknown    *__MIDL__IWiaMiniDrv0004,
  IUnknown    *__MIDL__IWiaMiniDrv0005,
  IWiaDrvItem **__MIDL__IWiaMiniDrv0006,
  IUnknown    **__MIDL__IWiaMiniDrv0007,
  LONG        *__MIDL__IWiaMiniDrv0008
);

Parámetros

__MIDL__IWiaMiniDrv0000

bstrDeviceID [in]

Especifica una cadena que contiene el identificador único del dispositivo.

__MIDL__IWiaMiniDrv0001

bstrRootFullItemName [in]

Especifica una cadena que contiene el nombre completo del elemento raíz.

__MIDL__IWiaMiniDrv0002

lFlags [in]

Reservado. Establecer en cero.

__MIDL__IWiaMiniDrv0003

pIUnknownOuter [in, optional]

(Opcional) Apunta a una ubicación de memoria que puede recibir la dirección de una interfaz IUnknown .

__MIDL__IWiaMiniDrv0004

pStiDevice [in, optional]

Apunta a una interfaz COM de IStiDevice.

__MIDL__IWiaMiniDrv0005

pWiasContext [in]

Puntero a un contexto de elemento WIA.

__MIDL__IWiaMiniDrv0006

plDevErrVal [out]

Apunta a una ubicación de memoria que recibirá un código de estado para este método. Si este método devuelve S_OK, el valor almacenado será cero. De lo contrario, este parámetro almacenará un código de error específico del minidriver en la ubicación a la que apunta este parámetro.

__MIDL__IWiaMiniDrv0007

ppIDrvItemRoot [out, opcional]

Apunta a una ubicación de memoria que recibirá la dirección de una interfaz IWiaDrvItem, la interfaz del elemento raíz.

__MIDL__IWiaMiniDrv0008

ppIUnknownInner [out, optional]

(Opcional) Apunta a una ubicación de memoria que puede recibir la dirección de una interfaz IUnknown . Si el minidriver tiene funcionalidad que no es accesible a través de la interfaz IWiaMiniDrv , el proveedor puede crear una interfaz independiente en el minidriver. Este parámetro proporciona acceso a esa funcionalidad.

Valor devuelto

Si se ejecuta correctamente, el método debe devolver S_OK y borrar el valor de error del dispositivo al que apunta plDevErrVal. Si se produce un error en el método, debe devolver un código de error COM estándar y colocar un valor de código de error específico del minidriver en la memoria a la que apunta plDevErrVal.

El valor al que apunta plDevErrVal se puede convertir en una cadena llamando a IWiaMiniDrv::d rvGetDeviceErrorStr.

Comentarios

Este método debe inicializar las estructuras privadas y crear el árbol de elementos del controlador. Para obtener información detallada sobre los pasos que suelen realizar los minidrivers en este método, vea Inicializar el minidriver WIA y Crear el árbol de elementos del controlador WIA.

El servicio WIA llama al método IWiaMiniDrv::d rvInitializeWia en respuesta a la llamada de un cliente a la función CreateDevice , lo que significa que se llama a este método una vez para cada nueva conexión de cliente.

Por ejemplo, si el usuario hace clic con el botón derecho en un icono del escáner WIA en Mi equipo, el shell llama a CreateDevice, que genera una llamada al método IWiaMiniDrv::d rvInitializeWia del minidriver. Si el usuario ejecuta el Asistente para adquisiciones de WIA, también llama a CreateDevice. Cada vez que se llama a CreateDevice , hay una llamada correspondiente al método IWiaMiniDrv::d rvInitializeWia en el minidriver.