Compartir a través de

STI_DEVICE_STATUS estructura (sti.h)

  • Artículo

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)