funzione wiasCreateDrvItem (wiamdef.h)

La funzione wiasCreateDrvItem crea un oggetto Interfaccia IWiaDrvItem .

Sintassi

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

Parametri

lObjectFlags

Specifica il tipo di elemento dell'oggetto, che deve essere WiaItemTypeFolder o WiaItemTypeFile (possibilmente l'OR bit per bit di questi). Questi flag sono descritti nei flag del tipo di elemento WIA.

bstrItemName

Specifica una stringa contenente il nome dell'elemento senza informazioni sul percorso.

bstrFullItemName

Specifica una stringa contenente il nome dell'elemento con le informazioni sul percorso.

[in, out] pIMiniDrv

Puntatore all'interfaccia IWiaMiniDrv del minidriver corrente.

cbDevSpecContext

Specifica le dimensioni in byte del contesto specifico del dispositivo.

[out] ppDevSpecContext

Puntatore a una posizione di memoria che riceve l'indirizzo del contesto specifico del dispositivo. Impostare questa opzione su NULL se le informazioni non sono necessarie.

[out] ppIWiaDrvItem

Puntatore a un percorso di memoria che riceve l'indirizzo di un'interfaccia IWiaDrvItem per l'oggetto IWiaDrvItem appena creato.

Valore restituito

In caso di esito positivo, la funzione restituisce S_OK.

Se la funzione ha esito negativo, restituisce un errore COM standard o uno dei codici di errore WIA.

Commenti

Questa funzione crea e inizializza un oggetto Interfaccia COM IWiaDrvItem con il nome e gli attributi specificati. Crea anche un contesto per l'oggetto IWiaDrvItem . I minidriver usano in genere questa funzione per creare un albero di elementi del dispositivo.

Requisiti

Vedi anche

wiasCreateChildAppItem