struktur STI_DEVICE_STATUS (sti.h)

Artikel
02/26/2024

Struktur STI_DEVICE_STATUS digunakan sebagai parameter untuk metode IStiDevice::GetStatus dan IStiUSD::GetStatus .

Sintaks

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

Anggota

dwSize

Ukuran yang disediakan penelepon, dalam byte, dari struktur STI_DEVICE_STATUS.

StatusMask

Satu atau beberapa bendera bit yang disediakan penelepon, menunjukkan jenis informasi status yang diminta. Bendera berikut didefinisikan:

Bendera	Definisi
STI_DEVSTATUS_EVENTS_STATE	Driver harus mengisi anggota dwEventHandlingState .
STI_DEVSTATUS_ONLINE_STATE	Driver harus mengisi anggota dwOnlineState .

dwOnlineState

Bendera bit yang menunjukkan status perangkat saat ini. Bendera berikut didefinisikan dalam Sti.h.

Saat ini penggunaan STI_ONLINESTATE_OPERATIONAL diperlukan, sementara penggunaan semua bendera lainnya bersifat opsional. (Saat ini, STI_ONLINESTATE_OPERATIONAL adalah satu-satunya bendera yang diperiksa server gambar diam.)

STI_ONLINESTATE_BUSY

Perangkat sibuk.

STI_ONLINESTATE_ERROR

Perangkat telah melaporkan kesalahan.

STI_ONLINESTATE_INITIALIZING

Perangkat sedang diinisialisasi.

STI_ONLINESTATE_IO_ACTIVE

Perangkat aktif tetapi tidak menerima perintah.

STI_ONLINESTATE_OFFLINE

Perangkat ini off-line.

STI_ONLINESTATE_OPERATIONAL

Perangkat sedang online dan siap. Jika diatur, Panel Kontrol menunjukkan perangkat sudah siap. Jika tidak, itu menunjukkan perangkat off-line.

STI_ONLINESTATE_PAPER_JAM

Perangkat telah melaporkan kemacetan kertas.

STI_ONLINESTATE_PAPER_PROBLEM

Perangkat telah melaporkan masalah kertas yang tidak ditentukan.

STI_ONLINESTATE_PAUSED

Perangkat dijeda.

STI_ONLINESTATE_PENDING

Operasi I/O tertunda.

STI_ONLINESTATE_POWER_SAVE

Perangkat dalam mode hemat daya.

STI_ONLINESTATE_TRANSFERRING

Perangkat mentransfer data.

STI_ONLINESTATE_USER_INTERVENTION

Perangkat memerlukan intervensi pengguna.

STI_ONLINESTATE_WARMING_UP

Perangkat sedang dipanaskan.

dwHardwareStatusCode

Nilai khusus perangkat opsional yang ditentukan vendor.

dwEventHandlingState

Berisi bendera bit yang menunjukkan status peristiwa. Bendera berikut didefinisikan dalam Sti.h.

STI_EVENTHANDLING_ENABLED

Tidak digunakan.

STI_EVENTHANDLING_PENDING

Terjadi peristiwa perangkat.

STI_EVENTHANDLING_POLLING