structure STI_DEVICE_STATUS (sti.h)

Article
03/05/2024

La structure STI_DEVICE_STATUS est utilisée comme paramètre pour les méthodes IStiDevice ::GetStatus et IStiUSD ::GetStatus .

Syntaxe

typedef struct _STI_DEVICE_STATUS {
  DWORD dwSize;
  DWORD StatusMask;
  DWORD dwOnlineState;
  DWORD dwHardwareStatusCode;
  DWORD dwEventHandlingState;
  DWORD dwPollingInterval;
} STI_DEVICE_STATUS, *PSTI_DEVICE_STATUS;

Membres

dwSize

Taille fournie par l’appelant, en octets, de la structure STI_DEVICE_STATUS.

StatusMask

Un ou plusieurs indicateurs de bits fournis par l’appelant, indiquant le type d’informations status demandées. Les indicateurs suivants sont définis :

Indicateur	Définition
STI_DEVSTATUS_EVENTS_STATE	Le pilote doit renseigner le membre dwEventHandlingState .
STI_DEVSTATUS_ONLINE_STATE	Le pilote doit renseigner le membre dwOnlineState .

dwOnlineState

Indicateurs de bits indiquant la status actuelle de l’appareil. Les indicateurs suivants sont définis dans Sti.h.

Actuellement, l’utilisation de STI_ONLINESTATE_OPERATIONAL est obligatoire, tandis que l’utilisation de tous les autres indicateurs est facultative. (Actuellement, STI_ONLINESTATE_OPERATIONAL est le seul indicateur que le serveur d’images fixes vérifie.)

STI_ONLINESTATE_BUSY

L’appareil est occupé.

STI_ONLINESTATE_ERROR

L’appareil a signalé une erreur.

STI_ONLINESTATE_INITIALIZING

L’appareil est en cours d’initialisation.

STI_ONLINESTATE_IO_ACTIVE

L’appareil est actif, mais n’accepte pas les commandes.

STI_ONLINESTATE_OFFLINE

L’appareil est hors ligne.

STI_ONLINESTATE_OPERATIONAL

L’appareil est en ligne et prêt. Si elle est définie, Panneau de configuration indique que l’appareil est prêt. Sinon, cela indique que l’appareil est hors ligne.

STI_ONLINESTATE_PAPER_JAM

L’appareil a signalé un bourrage de papier.

STI_ONLINESTATE_PAPER_PROBLEM

L’appareil a signalé un problème de papier non spécifié.

STI_ONLINESTATE_PAUSED

L’appareil est suspendu.

STI_ONLINESTATE_PENDING

Les opérations d’E/S sont en attente.

STI_ONLINESTATE_POWER_SAVE

L’appareil est en mode économie d’énergie.

STI_ONLINESTATE_TRANSFERRING

L’appareil transfère des données.

STI_ONLINESTATE_USER_INTERVENTION

L’appareil nécessite l’intervention de l’utilisateur.

STI_ONLINESTATE_WARMING_UP

L’appareil s’échauffe.

dwHardwareStatusCode

Valeur facultative spécifique à l’appareil, définie par le fournisseur.

dwEventHandlingState

Contient des indicateurs de bits indiquant l’status d’événement. Les indicateurs suivants sont définis dans Sti.h.

STI_EVENTHANDLING_ENABLED

Non utilisé.

STI_EVENTHANDLING_PENDING

Un événement d’appareil s’est produit.

STI_EVENTHANDLING_POLLING