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

Weitere Informationen

wiasCreateChildAppItem