Метод IStiDevice::Escape (sti.h)

Метод IStiDevice::Escape отправляет запрос на операцию ввода-вывода для конкретного поставщика на устройство по-прежнему.

Синтаксис

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

Параметры

[in] EscapeFunction

Вызываемое, определяемое поставщиком значение размера DWORD, представляющее операцию ввода-вывода. Мини-driver устройства должен распознать это значение и экспортировать интерфейс IStiUSD. Определяемые поставщиком значения должны быть больше STI_RAW_RESERVED, что определяется в Sti.h.

[in] lpInData

Вызывающий указатель на буфер, содержащий данные для отправки на устройство.

cbInDataSize

Длина вызывающего объекта в байтах данных, содержащихся в буфере, на которую указывает lpInData.

[in, out] pOutData

Вызывающий указатель на буфер памяти для получения данных с устройства.

dwOutDataSize

Длина вызываемого буфера в байтах, на которую указывает lpOutData.

[out] pdwActualData

Получает количество байтов, фактически записанных в pOutData.

Возвращаемое значение

Если операция выполнена успешно, метод возвращает S_OK. В противном случае возвращается один из кодов ошибок с префиксом STIERR, определенных в stierr.h.

Замечания

Метод IStiDevice::Escape вызывает вызовы IStiUSD::Escape, экспортируемые поставщиками мини-drivers. Мини-driver устройства определяет использование параметра Метода.

Перед вызовом IStiDevice::Escapeклиенты интерфейса IStiDevice должны вызывать IStillImage::CreateDevice для получения указателя интерфейса IStiDev ice, который предоставляет доступ к указанному устройству.

Вызов IStiDevice::Escape должен предшествовать вызову IStiDevice::LockDevice и вызову IStiDevice::UnLockDevice.

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	sti.h (include Sti.h)