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 ODER dieser Elemente). Diese Flags werden in WIA Item Type Flagsbeschrieben.
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 Interface des aktuellen Minidrivers.
cbDevSpecContext
Gibt die Größe in Byte des gerätespezifischen Kontexts an.
[out] ppDevSpecContext
Zeigen Sie auf einen Speicherspeicherort, der die Adresse des gerätespezifischen Kontexts empfängt. Legen Sie dies auf NULL- fest, wenn die Informationen nicht benötigt werden.
[out] ppIWiaDrvItem
Zeiger auf einen Speicherspeicherort, der die Adresse eines IWiaDrvItem Interface 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, wird ein STANDARDMÄßIGer COM-Fehler oder eine der WIA-Fehlercodeszurückgegeben.
Bemerkungen
Diese Funktion erstellt und initialisiert ein IWiaDrvItem COM Interface -Objekt mit dem angegebenen Namen und Attributen. Außerdem wird ein Kontext für das IWiaDrvItem-Objekt erstellt. Minidriver verwenden diese Funktion in der Regel zum Erstellen einer Struktur von Geräteelementen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | wiamdef.h (include Wiamdef.h) |
| Library | Wiaservc.lib |
| DLL- | Wiaservc.dll |