Metodo IStiUSD::Escape (stiusd.h)
Il metodo IStiUSD::Escape di un'immagine continua di un minidriver esegue un'operazione di I/O specifica del fornitore in un dispositivo di immagine ancora.
Sintassi
HRESULT Escape(
STI_RAW_CONTROL_CODE EscapeFunction,
LPVOID lpInData,
DWORD cbInDataSize,
LPVOID pOutData,
DWORD cbOutDataSize,
LPDWORD pdwActualData
);
Parametri
EscapeFunction
Valore DWORD definito dal fornitore fornito dal chiamante che rappresenta un'operazione di I/O. I valori definiti dal fornitore devono essere maggiori di STI_RAW_RESERVED, definito in Sti.h.
lpInData
Puntatore fornito dal chiamante a un buffer contenente i dati inviati al dispositivo.
cbInDataSize
Lunghezza specificata dal chiamante, in byte, del buffer a cui punta lpInData.
pOutData
Puntatore fornito dal chiamante a un buffer di memoria per ricevere dati dal dispositivo.
cbOutDataSize
Lunghezza specificata dal chiamante, in byte, del buffer a cui punta lpOutData.
pdwActualData
Riceve il numero di byte effettivamente scritti in pOutData.
Valore restituito
Se l'operazione ha esito positivo, il metodo deve restituire S_OK. In caso contrario, deve restituire uno dei codici di errore con prefisso STIERR definiti in stierr.h. Se il metodo non è implementato, deve restituire STIERR_UNSUPPORTED.
Commenti
Un minidriver di immagini deve implementare solo IStiUSD::Escape se sono necessarie operazioni di I/O che non possono essere implementate all'interno dei metodi IStiUSD::RawReadData, IStiUSD::RawWriteData, IStiUSD::RawReadCommand o IStiUSD::RawWriteCommand . Il minidriver definisce l'utilizzo dei parametri per IStiUSD::Escape.
Requisiti
Requisito | Valore |
---|---|
Piattaforma di destinazione | Desktop |
Intestazione | stiusd.h (include Stiusd.h) |