fonction wiasCreateDrvItem (wiamdef.h)

La fonction wiasCreateDrvItem crée un objet IWiaDrvItem Interface .

Syntaxe

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

Paramètres

lObjectFlags

Spécifie le type d’élément d’objet, qui doit être WiaItemTypeFolder ou WiaItemTypeFile (éventuellement l’OR au niveau du bit). Ces indicateurs sont décrits dans Indicateurs de type d’élément WIA.

bstrItemName

Spécifie une chaîne qui contient le nom de l’élément sans informations de chemin d’accès.

bstrFullItemName

Spécifie une chaîne qui contient le nom de l’élément avec des informations de chemin d’accès.

[in, out] pIMiniDrv

Pointeur vers l’interface IWiaMiniDrv du minidriver actuel.

cbDevSpecContext

Spécifie la taille en octets du contexte spécifique de l’appareil.

[out] ppDevSpecContext

Pointeur vers un emplacement de mémoire qui reçoit l’adresse du contexte spécifique de l’appareil. Définissez cette valeur sur NULL si les informations ne sont pas nécessaires.

[out] ppIWiaDrvItem

Pointeur vers un emplacement de mémoire qui reçoit l’adresse d’une interface IWiaDrvItem pour l’objet IWiaDrvItem nouvellement créé.

Valeur retournée

En cas de réussite, la fonction retourne S_OK.

Si la fonction échoue, elle retourne une erreur COM standard ou l’un des codes d’erreur WIA.

Remarques

Cette fonction crée et initialise un objet interface COM IWiaDrvItem avec le nom et les attributs spécifiés. Il crée également un contexte pour l’objet IWiaDrvItem . Les mini-drivers utilisent généralement cette fonction pour créer une arborescence d’éléments d’appareil.

Configuration requise

Voir aussi

wiasCreateChildAppItem