Compartilhar via

Método IWiaItem::D eviceCommand (wia_xp.h)

  • Artigo

O IWiaItem::D eviceCommand emite um comando para um dispositivo de hardware WIA (Aquisição de Imagens do Windows).

Sintaxe

HRESULT DeviceCommand(
  [in]      LONG       lFlags,
  [in]      const GUID *pCmdGUID,
  [in, out] IWiaItem   **pIWiaItem
);

Parâmetros

[in] lFlags

Tipo: LONG

Atualmente não utilizado. Deve ser definido como zero.

[in] pCmdGUID

Tipo: const GUID*

Especifica um identificador exclusivo que especifica o comando a ser enviado para o dispositivo de hardware WIA. Para obter uma lista de comandos de dispositivo válidos, consulte Comandos de dispositivo WIA.

[in, out] pIWiaItem

Tipo: IWiaItem**

Na saída, esse ponteiro aponta para o item criado pelo comando , se houver.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Os aplicativos usam esse método para enviar comandos WIA para dispositivos de hardware.

Quando o aplicativo envia o comando WIA_CMD_TAKE_PICTURE para o dispositivo, IWiaItem::D eviceCommand, o sistema de tempo de execução wia cria o objeto IWiaItem para representar a imagem. O método IWiaItem::D eviceCommand armazena o endereço da interface no parâmetro pIWiaItem .

Os aplicativos devem chamar o método IUnknown::Release nos ponteiros de interface que recebem por meio do parâmetro pIWiaItem .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wia_xp.h (inclua Wia.h)
Biblioteca Wiaguid.lib
DLL Wiaservc.dll