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
| Requirement | Value |
|---|---|
| Target Platform | Desktop |
| Header | wiamdef.h (include Wiamdef.h) |
| Library | Wiaservc.lib |
| DLL | Wiaservc.dll |