Compartilhar via


Função wiasCreateDrvItem (wiamdef.h)

A função wiasCreateDrvItem cria um objeto IWiaDrvItem Interface .

Sintaxe

HRESULT wiasCreateDrvItem(
            LONG        lObjectFlags,
            BSTR        bstrItemName,
            BSTR        bstrFullItemName,
  [in, out] IWiaMiniDrv *pIMiniDrv,
            LONG        cbDevSpecContext,
  [out]     BYTE        **ppDevSpecContext,
  [out]     IWiaDrvItem **ppIWiaDrvItem
);

Parâmetros

lObjectFlags

Especifica o tipo de item de objeto, que deve ser WiaItemTypeFolder ou WiaItemTypeFile (possivelmente o OR bit a bit destes). Esses sinalizadores são descritos em Sinalizadores de Tipo de Item WIA.

bstrItemName

Especifica uma cadeia de caracteres que contém o nome do item sem informações de caminho.

bstrFullItemName

Especifica uma cadeia de caracteres que contém o nome do item com informações de caminho.

[in, out] pIMiniDrv

Ponteiro para a Interface IWiaMiniDrv do minidriver atual.

cbDevSpecContext

Especifica o tamanho em bytes do contexto específico do dispositivo.

[out] ppDevSpecContext

Ponteiro para um local de memória que recebe o endereço do contexto específico do dispositivo. Defina isso como NULL se as informações não forem necessárias.

[out] ppIWiaDrvItem

Ponteiro para um local de memória que recebe o endereço de uma Interface IWiaDrvItem para o objeto IWiaDrvItem recém-criado.

Retornar valor

Em caso de êxito, a função retorna S_OK.

Se a função falhar, ela retornará um erro COM padrão ou um dos códigos de erro wia.

Comentários

Essa função cria e inicializa um objeto interface COM IWiaDrvItem com o nome e os atributos especificados. Ele também cria um contexto para o objeto IWiaDrvItem . Os minidrivers normalmente usam essa função para criar uma árvore de itens de dispositivo.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho wiamdef.h (inclua Wiamdef.h)
Biblioteca Wiaservc.lib
DLL Wiaservc.dll

Confira também

wiasCreateChildAppItem