Método IWiaItem2::D eviceCommand
Emite um comando para um dispositivo de hardware WIA (Aquisição de Imagens do Windows) 2.0.
Sintaxe
HRESULT DeviceCommand(
[in] LONG lFlags,
[in] const GUID *pCmdGUID,
[in, out] IWiaItem2 **ppIWiaItem2
);
Parâmetros
-
lFlags [in]
-
Tipo: LONG
Atualmente não utilizado. Deve ser definido como zero.
-
pCmdGUID [in]
-
Tipo: const GUID*
Especifica o comando a ser enviado para o dispositivo WIA 2.0. Consulte Comandos de dispositivo WIA.
-
ppIWiaItem2 [in, out]
-
Tipo: IWiaItem2**
Recebe o endereço de um ponteiro para o item IWiaItem2 criado pelo comando , se houver.
Valor retornado
Tipo: HRESULT
Além dos códigos de erro COM padrão, o método pode retornar o valor a seguir.
| Código de retorno | Descrição |
|---|---|
|
O comando não é implementado para a interface IWiaItem2 na qual o método é chamado. O valor numérico para esse erro ainda não está definido. |
Comentários
O comportamento desse método é diferente dependendo da categoria do nó no qual o método é chamado.
Quando o aplicativo envia o comando WIA_CMD_TAKE_PICTURE para o dispositivo usando o método IWiaItem2::D eviceCommand , o sistema de tempo de execução WIA 2.0 cria um objeto IWiaItem2 para representar a imagem. O método IWiaItem2::D eviceCommand armazena o endereço da interface no parâmetro ppIWiaItem2 .
Os aplicativos devem chamar o método IUnknown::Release nos ponteiros de interface que recebem por meio do parâmetro ppIWiaItem2 .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2008 [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
| IDL |
|