función wiasCreateDrvItem (wiamdef.h)

La función wiasCreateDrvItem crea un objeto IWiaDrvItem Interface.

Sintaxis

HRESULT wiasCreateDrvItem(
            LONG        lObjectFlags,
            BSTR        bstrItemName,
            BSTR        bstrFullItemName,
  [in, out] IWiaMiniDrv *pIMiniDrv,
            LONG        cbDevSpecContext,
  [out]     BYTE        **ppDevSpecContext,
  [out]     IWiaDrvItem **ppIWiaDrvItem
);

Parámetros

lObjectFlags

Especifica el tipo de elemento de objeto, que debe ser WiaItemTypeFolder o WiaItemTypeFile (posiblemente el OR bit a bit de estos). Estas marcas se describen en marcas de tipo de elemento WIA.

bstrItemName

Especifica una cadena que contiene el nombre del elemento sin información de ruta de acceso.

bstrFullItemName

Especifica una cadena que contiene el nombre del elemento con información de ruta de acceso.

[in, out] pIMiniDrv

Puntero al interfaz IWiaMiniDrv del minidriver actual.

cbDevSpecContext

Especifica el tamaño en bytes del contexto específico del dispositivo.

[out] ppDevSpecContext

Puntero a una ubicación de memoria que recibe la dirección del contexto específico del dispositivo. Establézcalo en NULL si no se necesita la información.

[out] ppIWiaDrvItem

Puntero a una ubicación de memoria que recibe la dirección de un IWiaDrvItem Interface para el objeto IWiaDrvIte m recién creado.

Valor devuelto

Si la función se ejecuta correctamente, devuelve S_OK.

Si se produce un error en la función, devuelve un error COM estándar o uno de los códigos de error WIA.

Observaciones

Esta función crea e inicializa un IWiaDrvItem COM Interface objeto con el nombre y los atributos especificados. También crea un contexto para el objeto IWiaDrvItem. Los minidrivers suelen usar esta función para crear un árbol de elementos de dispositivo.

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	wiamdef.h (incluya Wiamdef.h)
biblioteca de	Wiaservc.lib
DLL de	Wiaservc.dll

Consulte también

wiasCreateChildAppItem