Método IStiDevice::Escape (sti.h)

El método IStiDevice::Escape envía una solicitud de una operación de E/S específica del proveedor a un dispositivo de imagen todavía.

Sintaxis

HRESULT Escape(
  [in]      STI_RAW_CONTROL_CODE EscapeFunction,
  [in]      LPVOID               lpInData,
            DWORD                cbInDataSize,
  [in, out] LPVOID               pOutData,
            DWORD                dwOutDataSize,
  [out]     LPDWORD              pdwActualData
);

Parámetros

[in] EscapeFunction

Valor de tamaño DWORD, proporcionado por el autor de la llamada, definido por el proveedor, que representa una operación de E/S. El minidriver del dispositivo debe reconocer este valor y debe exportar una interfaz IStiUSD . Los valores definidos por el proveedor deben ser mayores que STI_RAW_RESERVED, que se define en Sti.h.

[in] lpInData

Puntero proporcionado por el autor de la llamada a un búfer que contiene los datos que se van a enviar al dispositivo.

cbInDataSize

Longitud proporcionada por el autor de la llamada, en bytes, de los datos contenidos en el búfer a los que apunta lpInData.

[in, out] pOutData

Puntero proporcionado por el autor de la llamada a un búfer de memoria para recibir datos del dispositivo.

dwOutDataSize

Longitud proporcionada por el autor de la llamada, en bytes, del búfer al que apunta lpOutData.

[out] pdwActualData

Recibe el número de bytes escritos realmente en pOutData.

Valor devuelto

Si la operación se realiza correctamente, el método devuelve S_OK. De lo contrario, devuelve uno de los códigos de error con prefijo STIERR definidos en stierr.h.

Comentarios

El método IStiDevice::Escape llama a IStiUSD::Escape, que se exporta mediante minidrivers suministrados por el proveedor. El minidriver del dispositivo define el uso del parámetro Method.

Antes de llamar a IStiDevice::Escape, los clientes de la interfaz COM IStiDevice deben llamar a IStillImage::CreateDevice para obtener un puntero de interfaz IStiDevice , que proporciona acceso a un dispositivo especificado.

Una llamada a IStiDevice::Escape debe ir precedida de una llamada a IStiDevice::LockDevice y seguida de una llamada a IStiDevice::UnLockDevice.

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	sti.h (include Sti.h)