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
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | wiamdef.h (include Wiamdef.h) |
| Libreria | Wiaservc.lib |
| DLL | Wiaservc.dll |