Compartir a través de

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

  • Artículo

IWiaItem::D eviceCommand emite un comando a un dispositivo de hardware de adquisición de imágenes de Windows (WIA).

Sintaxis

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

Parámetros

[in] lFlags

Tipo: LONG

Actualmente no se usa. Debe establecerse como cero.

[in] pCmdGUID

Tipo: GUID const*

Especifica un identificador único que especifica el comando que se va a enviar al dispositivo de hardware WIA. Para obtener una lista de los comandos válidos del dispositivo, consulte Comandos de dispositivo WIA.

[in, out] pIWiaItem

Tipo: IWiaItem**

En la salida, este puntero apunta al elemento creado por el comando, si existe.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Las aplicaciones usan este método para enviar comandos WIA a dispositivos de hardware.

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

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

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wia_xp.h (incluya Wia.h)
Library Wiaguid.lib
Archivo DLL Wiaservc.dll