STI_DEVICE_STATUS estructura (sti.h)
La estructura STI_DEVICE_STATUS se usa como parámetro para los métodos IStiDevice::GetStatus e IStiUSD::GetStatus .
Sintaxis
typedef struct _STI_DEVICE_STATUS {
DWORD dwSize;
DWORD StatusMask;
DWORD dwOnlineState;
DWORD dwHardwareStatusCode;
DWORD dwEventHandlingState;
DWORD dwPollingInterval;
} STI_DEVICE_STATUS, *PSTI_DEVICE_STATUS;
Miembros
dwSize
Tamaño proporcionado por el autor de la llamada, en bytes, de la estructura STI_DEVICE_STATUS.
StatusMask
Una o varias marcas de bits proporcionadas por el autor de la llamada, que indican el tipo de información de estado que se solicita. Se definen las marcas siguientes:
| Marca | Definición |
|---|---|
| STI_DEVSTATUS_EVENTS_STATE | El controlador debe rellenar el miembro dwEventHandlingState . |
| STI_DEVSTATUS_ONLINE_STATE | El controlador debe rellenar el miembro dwOnlineState . |
dwOnlineState
Marcas de bits que indican el estado actual del dispositivo. Las marcas siguientes se definen en Sti.h.
Actualmente se requiere el uso de STI_ONLINESTATE_OPERATIONAL, mientras que el uso de todas las demás marcas es opcional. (Actualmente, STI_ONLINESTATE_OPERATIONAL es la única marca que comprueba el servidor de imágenes).
STI_ONLINESTATE_BUSY
El dispositivo está ocupado.
STI_ONLINESTATE_ERROR
El dispositivo ha notificado un error.
STI_ONLINESTATE_INITIALIZING
El dispositivo se está inicializando.
STI_ONLINESTATE_IO_ACTIVE
El dispositivo está activo pero no acepta comandos.
STI_ONLINESTATE_OFFLINE
El dispositivo está fuera de línea.
STI_ONLINESTATE_OPERATIONAL
El dispositivo está en línea y listo. Si se establece, Panel de control indica que el dispositivo está listo. De lo contrario, indica que el dispositivo está fuera de línea.
STI_ONLINESTATE_PAPER_JAM
El dispositivo ha notificado un atasco de papel.
STI_ONLINESTATE_PAPER_PROBLEM
El dispositivo ha notificado un problema de papel no especificado.
STI_ONLINESTATE_PAUSED
El dispositivo está en pausa.
STI_ONLINESTATE_PENDING
Las operaciones de E/S están pendientes.
STI_ONLINESTATE_POWER_SAVE
El dispositivo está en modo de ahorro de energía.
STI_ONLINESTATE_TRANSFERRING
El dispositivo transfiere datos.
STI_ONLINESTATE_USER_INTERVENTION
El dispositivo requiere la intervención del usuario.
STI_ONLINESTATE_WARMING_UP
El dispositivo se está preparando.
dwHardwareStatusCode
Valor opcional específico del dispositivo definido por el proveedor.
dwEventHandlingState
Contiene marcas de bits que indican el estado del evento. Las marcas siguientes se definen en Sti.h.
STI_EVENTHANDLING_ENABLED
No se usa.
STI_EVENTHANDLING_PENDING
Se ha producido un evento de dispositivo.
STI_EVENTHANDLING_POLLING
No se usa.
dwPollingInterval
Valor de tiempo, en milisegundos, que indica la frecuencia con la que se debe sondear el dispositivo, si se requiere sondeo.
Requisitos
| Requisito | Valor |
|---|---|
| Header | sti.h (include Sti.h) |