Método IWiaItem2::D eviceCommand

Emite un comando a un dispositivo de hardware windows Image Acquisition (WIA) 2.0.

Sintaxis

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

Parámetros

lFlags [in]

Tipo: LONG

Actualmente no se usa. Debe establecerse como cero.

pCmdGUID [in]

Tipo: GUID const*

Especifica el comando que se va a enviar al dispositivo WIA 2.0. Consulte Comandos de dispositivo WIA.

ppIWiaItem2 [in, out]

Tipo: IWiaItem2**

Recibe la dirección de un puntero al elemento IWiaItem2 creado por el comando, si existe.

Valor devuelto

Tipo: HRESULT

Además de los códigos de error COM estándar, el método puede devolver el siguiente valor.

Código devuelto	Descripción
E_CMDNOTSUPPORTED	El comando no se implementa para la interfaz IWiaItem2 en la que se llama al método . El valor numérico de este error aún no está definido.

 

Comentarios

El comportamiento de este método es diferente en función de la categoría del nodo al que se llama al método.

Cuando la aplicación envía el comando WIA_CMD_TAKE_PICTURE al dispositivo mediante el método IWiaItem2::D eviceCommand , el sistema en tiempo de ejecución de WIA 2.0 crea un objeto IWiaItem2 para representar la imagen. El método IWiaItem2::D eviceCommand almacena la dirección de la interfaz en el parámetro ppIWiaItem2 .

Las aplicaciones deben llamar al método IUnknown::Release en los punteros de interfaz que reciben a través del parámetro ppIWiaItem2 .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	Wia.h
IDL	Wia.idl