Método IStiUSD::Escape (stiusd.h)

Um método IStiUSD::Escape do minidriver de imagem ainda executa uma operação de E/S específica do fornecedor em um dispositivo de imagem parada.

Sintaxe

HRESULT Escape(
  STI_RAW_CONTROL_CODE EscapeFunction,
  LPVOID               lpInData,
  DWORD                cbInDataSize,
  LPVOID               pOutData,
  DWORD                cbOutDataSize,
  LPDWORD              pdwActualData
);

Parâmetros

EscapeFunction

Valor de tamanho DWORD fornecido pelo chamador, definido pelo fornecedor, que representa uma operação de E/S. Os valores definidos pelo fornecedor devem ser maiores que STI_RAW_RESERVED, que é definido em Sti.h.

lpInData

Ponteiro fornecido pelo chamador para um buffer que contém dados enviados para o dispositivo.

cbInDataSize

Comprimento fornecido pelo chamador, em bytes, do buffer apontado por lpInData.

pOutData

Ponteiro fornecido pelo chamador para um buffer de memória para receber dados do dispositivo.

cbOutDataSize

Comprimento fornecido pelo chamador, em bytes, do buffer apontado por lpOutData.

pdwActualData

Recebe o número de bytes realmente gravados em pOutData.

Retornar valor

Se a operação for bem-sucedida, o método deverá retornar S_OK. Caso contrário, ele deverá retornar um dos códigos de erro prefixados por STIERR definidos em stierr.h. Se o método não for implementado, ele deverá retornar STIERR_UNSUPPORTED.

Comentários

Um minidriver de imagem parada só precisará implementar métodos IStiUSD::Escape se forem necessárias operações de E/S que não possam ser implementadas nos métodos IStiUSD::RawReadData, IStiUSD::RawWriteData, IStiUSD::RawReadCommand ou IStiUSD::RawWriteCommand . O minidriver define o uso de parâmetro para IStiUSD::Escape.

Requisitos

Requisito	Valor
Plataforma de Destino	Área de Trabalho
Cabeçalho	stiusd.h (inclua Stiusd.h)

Confira também

IStiDevice::Escape

IStiUSD