Método IWiaMiniDrv::d rvInitializeWia (wiamindr_lh.h)

Artigo
08/08/2023

O método IWiaMiniDrv::d rvInitializeWia inicializa o minidriver e cria a árvore de itens do driver que representa o dispositivo.

Sintaxe

HRESULT drvInitializeWia(
  BYTE        *__MIDL__IWiaMiniDrv0000,
  LONG        __MIDL__IWiaMiniDrv0001,
  BSTR        __MIDL__IWiaMiniDrv0002,
  BSTR        __MIDL__IWiaMiniDrv0003,
  IUnknown    *__MIDL__IWiaMiniDrv0004,
  IUnknown    *__MIDL__IWiaMiniDrv0005,
  IWiaDrvItem **__MIDL__IWiaMiniDrv0006,
  IUnknown    **__MIDL__IWiaMiniDrv0007,
  LONG        *__MIDL__IWiaMiniDrv0008
);

Parâmetros

__MIDL__IWiaMiniDrv0000

bstrDeviceID [in]

Especifica uma cadeia de caracteres que contém o identificador exclusivo do dispositivo.

__MIDL__IWiaMiniDrv0001

bstrRootFullItemName [in]

Especifica uma cadeia de caracteres que contém o nome completo do item raiz.

__MIDL__IWiaMiniDrv0002

lFlags [in]

Reservado. Defina como zero.

__MIDL__IWiaMiniDrv0003

pIUnknownOuter [in, opcional]

(Opcional) Aponta para um local de memória que pode receber o endereço de uma interface IUnknown .

__MIDL__IWiaMiniDrv0004

pStiDevice [in, opcional]

Aponta para uma interface COM IStiDevice.

__MIDL__IWiaMiniDrv0005

pWiasContext [in]

Ponteiro para um contexto de item WIA.

__MIDL__IWiaMiniDrv0006

plDevErrVal [out]

Aponta para um local de memória que receberá um código status para esse método. Se esse método retornar S_OK, o valor armazenado será zero. Caso contrário, um código de erro específico do minidriver será armazenado no local apontado por esse parâmetro.

__MIDL__IWiaMiniDrv0007

ppIDrvItemRoot [out, opcional]

Aponta para um local de memória que receberá o endereço de uma Interface IWiaDrvItem, a interface do item raiz.

__MIDL__IWiaMiniDrv0008

ppIUnknownInner [out, opcional]

(Opcional) Aponta para um local de memória que pode receber o endereço de uma interface IUnknown . Se o minidriver tiver funcionalidade que não está acessível por meio da interface IWiaMiniDrv , o fornecedor poderá criar uma interface separada no minidriver. Esse parâmetro fornece acesso a essa funcionalidade.

Retornar valor

Em caso de êxito, o método deve retornar S_OK e limpar o valor de erro do dispositivo apontado por plDevErrVal. Se o método falhar, ele deverá retornar um código de erro COM padrão e colocar um valor de código de erro específico do minidriver na memória apontada por plDevErrVal.

O valor apontado por plDevErrVal pode ser convertido em uma cadeia de caracteres chamando IWiaMiniDrv::d rvGetDeviceErrorStr.

Comentários

Esse método deve inicializar quaisquer estruturas privadas e criar a árvore de itens de driver. Para obter informações detalhadas sobre as etapas que os minidrivers normalmente executam nesse método, consulte Inicializando o minidriver WIA e Criando a árvore de itens do driver WIA.

O serviço WIA chama o método IWiaMiniDrv::d rvInitializeWia em resposta à chamada de um cliente para a função CreateDevice , o que significa que esse método é chamado uma vez para cada nova conexão de cliente.

Por exemplo, se o usuário clicar com o botão direito do mouse em um ícone de scanner WIA em Meu Computador, o shell chamará CreateDevice, o que gerará uma chamada para o método IWiaMiniDrv::d rvInitializeWia do minidriver. Se o usuário executar o Assistente de Aquisição do WIA, ele também chamará CreateDevice. Sempre que CreateDevice é chamado, há uma chamada correspondente para o método IWiaMiniDrv::d rvInitializeWia no minidriver.