wiasCreateDrvItem function (wiamdef.h)

The wiasCreateDrvItem function creates an IWiaDrvItem Interface object.

Syntax

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

Parameters

lObjectFlags

Specifies the object item type, which must be WiaItemTypeFolder or WiaItemTypeFile (possibly the bitwise OR of these). These flags are described in WIA Item Type Flags.

bstrItemName

Specifies a string that contains the item name without path information.

bstrFullItemName

Specifies a string that contains the item name with path information.

[in, out] pIMiniDrv

Pointer to the IWiaMiniDrv Interface of the current minidriver.

cbDevSpecContext

Specifies the size in bytes of the device specific context.

[out] ppDevSpecContext

Pointer to a memory location that receives the address of the device specific context. Set this to NULL if the information is not needed.

[out] ppIWiaDrvItem

Pointer to a memory location that receives the address of an IWiaDrvItem Interface for the newly created IWiaDrvItem object.

Return value

On success, the function returns S_OK.

If the function fails, it returns a standard COM error or one of the WIA error codes.

Remarks

This function creates and initializes an IWiaDrvItem COM Interface object with the specified name and attributes. It also creates a context for the IWiaDrvItem object. Minidrivers typically use this function to build a tree of device items.

Requirements

See also

wiasCreateChildAppItem