wiasCreateDrvItem-Funktion (wiamdef.h)
Die wiasCreateDrvItem-Funktion erstellt ein IWiaDrvItem-Interface-Objekt .
Syntax
HRESULT wiasCreateDrvItem(
LONG lObjectFlags,
BSTR bstrItemName,
BSTR bstrFullItemName,
[in, out] IWiaMiniDrv *pIMiniDrv,
LONG cbDevSpecContext,
[out] BYTE **ppDevSpecContext,
[out] IWiaDrvItem **ppIWiaDrvItem
);
Parameter
lObjectFlags
Gibt den Objektelementtyp an, der WiaItemTypeFolder oder WiaItemTypeFile sein muss (möglicherweise das bitweise OR dieser Elemente). Diese Flags werden unter WIA-Elementtypflags beschrieben.
bstrItemName
Gibt eine Zeichenfolge an, die den Elementnamen ohne Pfadinformationen enthält.
bstrFullItemName
Gibt eine Zeichenfolge an, die den Elementnamen mit Pfadinformationen enthält.
[in, out] pIMiniDrv
Zeiger auf die IWiaMiniDrv-Schnittstelle des aktuellen Minitreibers.
cbDevSpecContext
Gibt die Größe des gerätespezifischen Kontexts in Byte an.
[out] ppDevSpecContext
Zeiger auf einen Speicherort, der die Adresse des gerätespezifischen Kontexts empfängt. Legen Sie diesen Wert auf NULL fest, wenn die Informationen nicht benötigt werden.
[out] ppIWiaDrvItem
Zeiger auf einen Speicherspeicherort, der die Adresse einer IWiaDrvItem-Schnittstelle für das neu erstellte IWiaDrvItem-Objekt empfängt.
Rückgabewert
Bei Erfolg gibt die Funktion S_OK zurück.
Wenn die Funktion fehlschlägt, gibt sie einen COM-Standardfehler oder einen der WIA-Fehlercodes zurück.
Hinweise
Diese Funktion erstellt und initialisiert ein IWiaDrvItem COM Interface-Objekt mit dem angegebenen Namen und den angegebenen Attributen. Außerdem wird ein Kontext für das IWiaDrvItem-Objekt erstellt. Minidriver verwenden diese Funktion in der Regel, um eine Struktur von Geräteelementen zu erstellen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | wiamdef.h (wiamdef.h einschließen) |
| Bibliothek | Wiaservc.lib |
| DLL | Wiaservc.dll |