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 in flag di 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 informazioni sul percorso.
[in, out] pIMiniDrv
Puntatore alla 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 una posizione di memoria che riceve l'indirizzo di un interfaccia IWiaDrvItem per l'oggetto IWiaDrv Item 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 .
Osservazioni
Questa funzione crea e inizializza un 'interfaccia COM IWiaDrvItem oggetto 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.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | wiamdef.h (include Wiamdef.h) |
| libreria | Wiaservc.lib |
| dll | Wiaservc.dll |