Bagikan melalui

kelas CIM_Battery

  • Artikel

Kelas CIM_Battery mewakili kemampuan dan manajemen perangkat logis baterai. Kelas ini berlaku untuk baterai dalam sistem laptop dan baterai internal dan eksternal lainnya.

Penting

Kelas CIM (Model Informasi Umum) DMTF (Distributed Management Task Force) adalah kelas induk tempat kelas WMI dibangun. WMI saat ini hanya mendukung skema versi CIM 2.x.

Sintaks berikut disederhanakan dari kode Managed Object Format (MOF) dan menyertakan semua properti yang diwariskan. Properti tercantum dalam urutan alfabet, bukan urutan MOF.

Sintaks

[Abstract, UUID("{8502C548-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class CIM_Battery : CIM_LogicalDevice
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  uint16   Availability;
  uint32   ConfigManagerErrorCode;
  boolean  ConfigManagerUserConfig;
  string   CreationClassName;
  string   DeviceID;
  uint16   PowerManagementCapabilities[];
  boolean  ErrorCleared;
  string   ErrorDescription;
  uint32   LastErrorCode;
  string   PNPDeviceID;
  boolean  PowerManagementSupported;
  uint16   StatusInfo;
  string   SystemCreationClassName;
  string   SystemName;
  uint16   BatteryStatus;
  uint16   Chemistry;
  uint32   DesignCapacity;
  uint64   DesignVoltage;
  uint16   EstimatedChargeRemaining;
  uint32   EstimatedRunTime;
  uint32   ExpectedLife;
  uint32   FullChargeCapacity;
  uint32   MaxRechargeTime;
  string   SmartBatteryVersion;
  uint32   TimeOnBattery;
  uint32   TimeToFullCharge;
};

Anggota

Kelas CIM_Battery memiliki jenis anggota ini:

Metode

Kelas CIM_Battery memiliki metode ini.

Metode Deskripsi
Mengatur ulang Meminta reset perangkat logis. Tidak diimplementasikan oleh WMI.
SetPowerState Menentukan status daya yang diinginkan untuk perangkat logis dan kapan perangkat harus dimasukkan ke dalam status tersebut. Tidak diimplementasikan oleh WMI.

Properti

Kelas CIM_Battery memiliki properti ini.

Ketersediaan

Jenis data: uint16

Jenis akses: Baca-saja

Kualifikasi: MappingStrings ("MIF. DMTF| Status Operasional|003.5", "MIB. IETF| HOST-RESOURCES-MIB.hrDeviceStatus")

Ketersediaan dan status perangkat.

Properti ini diwarisi dari CIM_LogicalDevice.

Lainnya (1)

Tidak diketahui (2)

Daya Berjalan/Penuh (3)

Peringatan (4)

Dalam Pengujian (5)

Tidak Berlaku (6)

Matikan Daya (7)

Off Line (8)

Off Duty (9)

Terdegradasi (10)

Tidak Terinstal (11)

Kesalahan Penginstalan (12)

Power Save - Tidak diketahui (13)

Perangkat ini diketahui berada dalam mode hemat daya, tetapi status pastinya tidak diketahui.

Power Save - Mode Daya Rendah (14)

Perangkat dalam status hemat daya tetapi masih berfungsi, dan dapat menunjukkan performa yang menurun.

Power Save - Siaga (15)

Perangkat tidak berfungsi tetapi dapat dibawa ke daya penuh dengan cepat.

Siklus Daya (16)

Power Save - Peringatan (17)

Perangkat dalam status peringatan, meskipun juga dalam mode hemat daya.

Dijeda (18)

Perangkat dijeda.

Belum Siap (19)

Perangkat belum siap.

Tidak Dikonfigurasi (20)

Perangkat tidak dikonfigurasi.

Didiamkan (21)

Perangkat ini tenang.

BatteryStatus

Jenis data: uint16

Jenis akses: Baca-saja

Kualifikasi: MappingStrings ("MIF. DMTF| Baterai Portabel|002.14")

Deskripsi status pengisian daya baterai. Nilai 10 tidak valid dalam skema CIM, yang mewakili tidak ada baterai yang dipasang di Desktop Management Interface (DMI). Dalam hal ini, objek tidak boleh diinstansiasi.

Lainnya (1)

Lainnya.

Tidak diketahui (2)

Tidak dikenal.

Terisi Penuh (3)

Terisi penuh.

Rendah (4)

Rendah.

Kritis (5)

Kritis.

Pengisian daya (6)

Pengisian.

Pengisian Daya dan Tinggi (7)

Pengisian daya dan tinggi.

Pengisian daya dan Rendah (8)

Pengisian daya dan rendah.

Pengisian Daya dan Kritis (9)

Pengisian daya dan kritis.

Tidak ditentukan (10)

Tidak ditentukan.

Dibebankan Sebagian (11)

Sebagian dibebankan.

Keterangan

Jenis data: string

Jenis akses: Baca-saja

Kualifikasi: MaxLen (64), DisplayName ("Keterangan")

Deskripsi tekstual singkat dari objek .

Properti ini diwarisi dari CIM_ManagedSystemElement.

Kimia

Jenis data: uint16

Jenis akses: Baca-saja

Kualifikasi: MappingStrings ("MIF. DMTF| Baterai Portabel|002,7")

Enumerasi yang menggambarkan kimia baterai.

Lainnya (1)

Lainnya.

Tidak diketahui (2)

Tidak dikenal.

Asam Timbal (3)

Asam timbal.

Kadmium Nikel (4)

Nikel cadmium.

Nikel Logam Hydride (5)

Nikel logam hidrida.

Litium-ion (6)

Lithium ion.

Udara seng (7)

Udara seng.

Polimer Lithium (8)

Polimer lithium.

ConfigManagerErrorCode

Jenis data: uint32

Jenis akses: Baca-saja

Kualifikasi: Skema ("Win32")

Kode kesalahan Win32 Configuration Manager.

Properti ini diwarisi dari CIM_LogicalDevice.

Perangkat ini bekerja dengan baik. (0)

Perangkat ini tidak dikonfigurasi dengan benar. (1)

Windows tak bisa memuat pengandar untuk perangkat ini. (2)

Pengandar untuk perangkat ini mungkin rusak, atau sistem Anda mungkin hampir kehabisan memori atau sumber daya lainnya. (3)

Perangkat ini tidak berfungsi dengan baik. Salah satu driver atau registri Anda mungkin rusak. (4)

Pengandar untuk perangkat ini membutuhkan sumber daya yang tak bisa dikelola Windows. (5)

Konfigurasi boot untuk perangkat ini berkonflik dengan perangkat lain. (6)

Tidak dapat memfilter. (7)

Pemuat driver untuk perangkat hilang. (8)

Perangkat ini tidak berfungsi dengan baik karena firmware pengontrol melaporkan sumber daya untuk perangkat dengan tidak benar. (9)

Perangkat ini tidak dapat dimulai. (10)

Perangkat ini gagal. (11)

Perangkat ini tidak dapat menemukan cukup sumber daya gratis yang dapat digunakannya. (12)

Windows tak bisa memverifikasi sumber daya perangkat ini. (13)

Perangkat ini tak bisa bekerja dengan baik sampai Anda memulai-ulang komputer. (14)

Perangkat ini tidak berfungsi dengan baik karena mungkin ada masalah enumerasi ulang. (15)

Windows tak bisa mengidentifikasi semua sumber daya yang digunakan perangkat ini. (16)

Perangkat ini meminta tipe sumber daya yang tidak diketahui. (17)

Instal ulang pengandar untuk perangkat ini. (18)

Kegagalan menggunakan loader VxD. (19)

Registri Anda mungkin rusak. (20)

Kegagalan sistem: Coba ubah driver untuk perangkat ini. Jika tidak berhasil, lihat dokumentasi perangkat keras Anda. Windows sedang menghapus perangkat ini. (21)

Perangkat ini dinon-fungsikan. (22)

Kegagalan sistem: Coba ubah driver untuk perangkat ini. Jika tidak berhasil, lihat dokumentasi perangkat keras Anda. (23)

Perangkat ini tidak ada, tidak berfungsi dengan baik, atau tidak memiliki semua pengandarnya yang terinstal. (24)

Windows masih menyetel perangkat ini. (25)

Windows masih menyetel perangkat ini. (26)

Perangkat ini tidak memiliki konfigurasi log yang valid. (27)

Pengandar untuk perangkat ini tidak terinstal. (28)

Perangkat ini dinonaktifkan karena firmware perangkat tidak memberikan sumber daya yang diperlukan. (29)

Perangkat ini menggunakan sumber daya Interrupt Request (IRQ) yang digunakan perangkat lain. (30)

Perangkat ini tak bekerja dengan semestinya karena Windows tak bisa memuat pengandar yang diperlukan untuk peranti ini. (31)

ConfigManagerUserConfig

Jenis data: boolean

Jenis akses: Baca-saja

Kualifikasi: Skema ("Win32")

Jika TRUE, perangkat menggunakan konfigurasi yang ditentukan pengguna.

Properti ini diwarisi dari CIM_LogicalDevice.

CreationClassName

Jenis data: string

Jenis akses: Baca-saja

Kualifikasi: CIM_Key

Nama kelas atau subkelas yang digunakan dalam pembuatan instans. Saat digunakan dengan properti utama kelas lainnya, properti ini memungkinkan semua instans kelas dan subkelasnya diidentifikasi secara unik.

Properti ini diwarisi dari CIM_LogicalDevice.

Deskripsi

Jenis data: string

Jenis akses: Baca-saja

Kualifikasi: DisplayName ("Description")

Deskripsi tekstual objek.

Properti ini diwarisi dari CIM_ManagedSystemElement.

DesignCapacity

Jenis data: uint32

Jenis akses: Baca-saja

Kualifikasi: MappingStrings ("MIF. DMTF| Baterai Portabel|002,8"), Unit ("milliwatt-hours")

Kapasitas baterai yang dirancang dalam miliwatt-jam. Jika properti ini tidak didukung, masukkan 0.

DesignVoltage

Jenis data: uint64

Jenis akses: Baca-saja

Kualifikasi: MappingStrings ("MIF. DMTF| Baterai Portabel|002,9"), Unit ("milivolt")

Tegangan baterai yang dirancang dalam milivolt. Jika atribut ini tidak didukung, masukkan 0.

Untuk informasi selengkapnya tentang menggunakan nilai uint64 dalam skrip, lihat Pembuatan skrip di WMI.

DeviceID

Jenis data: string

Jenis akses: Baca-saja

Kualifikasi: CIM_Key

Alamat atau informasi identifikasi lainnya untuk memberi nama perangkat logis secara unik.

Properti ini diwarisi dari CIM_LogicalDevice.

ErrorCleared

Jenis data: boolean

Jenis akses: Baca-saja

Jika TRUE, kesalahan yang dilaporkan di properti LastErrorCode sekarang dihapus.

Properti ini diwarisi dari CIM_LogicalDevice.

ErrorDescription

Jenis data: string

Jenis akses: Baca-saja

String bentuk bebas yang menyediakan informasi tentang kesalahan yang dicatat dalam properti LastErrorCode dan tindakan korektif untuk dilakukan.

Properti ini diwarisi dari CIM_LogicalDevice.

EstimatedChargeRemaining

Jenis data: uint16

Jenis akses: Baca-saja

Kualifikasi: Unit ("persen")

Estimasi persentase sisa biaya penuh.

EstimatedRunTime

Jenis data: uint32

Jenis akses: Baca-saja

Kualifikasi: MappingStrings ("MIF. DMTF| Baterai Portabel|002.15"), Unit ("menit")

Perkiraan waktu, dalam hitungan menit, hingga daya baterai habis dalam kondisi beban saat ini jika daya utilitas mati, hilang dan tetap mati, atau jika laptop terputus dari sumber daya.

ExpectedLife

Jenis data: uint32

Jenis akses: Baca-saja

Kualifikasi: Unit ("menit")

Masa pakai baterai yang diharapkan, dalam menit, dengan asumsi bahwa baterai terisi penuh. Properti ini mewakili total masa pakai baterai yang diharapkan, bukan sisa masa pakainya saat ini, yang ditunjukkan oleh properti EstimatedRunTime .

FullChargeCapacity

Jenis data: uint32

Jenis akses: Baca-saja

Kualifikasi: MappingStrings ("MIF. DMTF| Baterai Portabel|002.11"), Unit ("milliwatt-hours")

Kapasitas daya penuh baterai dalam miliwatt-jam. Bandingkan nilai ini dengan properti DesignCapacity untuk menentukan kapan baterai memerlukan penggantian. Masa pakai baterai biasanya terjadi ketika properti FullChargeCapacity berada di bawah 80 persen properti DesignCapacity . Jika properti ini tidak didukung, masukkan 0.

InstallDate

Jenis data: tanggalwaktu

Jenis akses: Baca-saja

Kualifikasi: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Tanggal Penginstalan")

Menunjukkan kapan objek diinstal. Kurangnya nilai tidak menunjukkan bahwa objek tidak diinstal.

Properti ini diwarisi dari CIM_ManagedSystemElement.

LastErrorCode

Jenis data: uint32

Jenis akses: Baca-saja

Kode kesalahan terakhir yang dilaporkan oleh perangkat logis.

Properti ini diwarisi dari CIM_LogicalDevice.

MaxRechargeTime

Jenis data: uint32

Jenis akses: Baca-saja

Kualifikasi: Unit ("menit")

Waktu maksimum, dalam menit, untuk mengisi daya baterai sepenuhnya. Properti ini menunjukkan waktu untuk mengisi ulang baterai yang sepenuhnya habis, bukan waktu pengisian daya yang tersisa saat ini, yang ditunjukkan di properti TimeToFullCharge .

Nama

Jenis data: string

Jenis akses: Baca-saja

Kualifikasi: DisplayName ("Name")

Label tempat objek diketahui. Ketika disubkelas, properti ini dapat diganti menjadi properti kunci.

Properti ini diwarisi dari CIM_ManagedSystemElement.

PNPDeviceID

Jenis data: string

Jenis akses: Baca-saja

Kualifikasi: Skema ("Win32")

Menunjukkan pengidentifikasi perangkat Win32 Plug and Play perangkat logis.

Contoh: "*PNP030b"

Properti ini diwarisi dari CIM_LogicalDevice.

PowerManagementCapabilities

Jenis data: array uint16

Jenis akses: Baca-saja

Menunjukkan kemampuan terkait daya tertentu dari perangkat logis.

Properti ini diwarisi dari CIM_LogicalDevice.

Tidak diketahui (0)

Kapasitas terkait daya tidak diketahui.

Tidak Didukung (1)

Kapasitas terkait daya tidak didukung untuk perangkat ini.

Dinonaktifkan (2)

Kapasitas terkait daya telah dinonaktifkan.

Diaktifkan (3)

Fitur manajemen daya saat ini diaktifkan tetapi set fitur yang tepat tidak diketahui atau informasi tidak tersedia.

Mode Hemat Daya Dimasukkan Secara Otomatis (4)

Perangkat dapat mengubah status dayanya berdasarkan penggunaan atau kriteria lainnya.

Power State Settable (5)

Metode SetPowerState didukung. Metode ini ditemukan pada kelas CIM_LogicalDevice induk dan dapat diimplementasikan. Untuk informasi selengkapnya, lihat Mendesain Kelas Managed Object Format (MOF).

Power Cycling Didukung (6)

Metode SetPowerState dapat dipanggil dengan parameter PowerState diatur ke 5 ("Power Cycle").

Daya Berwakla didukung (7)

Metode SetPowerState dapat dipanggil dengan parameter PowerState diatur ke 5 ("Power Cycle") dan parameter Waktu diatur ke tanggal dan waktu tertentu, atau interval, untuk power-on.

PowerManagementSupported

Jenis data: boolean

Jenis akses: Baca-saja

Jika TRUE, perangkat dapat dikelola daya, yaitu, dimasukkan ke dalam status hemat daya. Jika FALSE, nilai bilangan bulat 1 ("Tidak Didukung") harus menjadi satu-satunya entri dalam array PowerManagementCapabilities .

Properti ini tidak menunjukkan apakah fitur manajemen daya saat ini diaktifkan, atau jika diaktifkan, fitur mana yang didukung. Untuk informasi selengkapnya, lihat array PowerManagementCapabilities .

Properti ini diwarisi dari CIM_LogicalDevice.

SmartBatteryVersion

Jenis data: string

Jenis akses: Baca-saja

Kualifikasi: MaxLen (64), MappingStrings ("MIF. DMTF| Baterai Portabel|002.10")

Nomor versi spesifikasi data baterai pintar yang didukung oleh baterai ini. Jika baterai tidak mendukung fungsi ini, nilainya harus dibiarkan kosong.

Status

Jenis data: string

Jenis akses: Baca-saja

Kualifikasi: MaxLen (10), DisplayName ("Status")

String yang menunjukkan status objek saat ini. Status operasional dan non-operasional dapat ditentukan. Status operasional dapat mencakup "OK", "Degraded", dan "Pred Fail". "Pred Fail" menunjukkan bahwa elemen berfungsi dengan baik, tetapi memprediksi kegagalan (misalnya, hard disk drive berkemampuan SMART).

Status non-operasional dapat mencakup "Error", "Starting", "Stopping", dan "Service". "Layanan" dapat berlaku selama resilvering cermin disk, memuat ulang daftar izin pengguna, atau pekerjaan administratif lainnya. Tidak semua pekerjaan seperti itu online, tetapi elemen terkelola tidak "OK" atau di salah satu status lainnya.

Properti ini diwarisi dari CIM_ManagedSystemElement.

Nilai yang valid mencakup sebagai berikut:

OK ("OK")

Kesalahan ("Kesalahan")

Terdegradasi ("Terdegradasi")

Tidak diketahui ("Tidak Diketahui")

Pred Fail ("Pred Fail")

Memulai ("Memulai")

Menghentikan ("Berhenti")

Layanan ("Layanan")

Stres ("Stres")

NonRecover ("NonRecover")

Tidak Ada Kontak ("Tidak Ada Kontak")

Lost Comm ("Lost Comm")

StatusInfo

Jenis data: uint16

Jenis akses: Baca-saja

Kualifikasi: MappingStrings ("MIF. DMTF| Status Operasional|003.3")

Status perangkat logis. Jika properti ini tidak berlaku untuk perangkat logis, nilai 5 ("Tidak Berlaku") harus digunakan.

Properti ini diwarisi dari CIM_LogicalDevice.

Lainnya (1)

Tidak diketahui (2)

Diaktifkan (3)

Dinonaktifkan (4)

Tidak Berlaku (5)

SystemCreationClassName

Jenis data: string

Jenis akses: Baca-saja

Kualifikasi: Disebarluaskan ("CIM_System. CreationClassName"), CIM_Key

Nama kelas pembuatan sistem cakupan.

Properti ini diwarisi dari CIM_LogicalDevice.

SystemName

Jenis data: string

Jenis akses: Baca-saja

Kualifikasi: Disebarluaskan ("CIM_System. Nama"), CIM_Key

Nama sistem cakupan.

Properti ini diwarisi dari CIM_LogicalDevice.

TimeOnBattery

Jenis data: uint32

Jenis akses: Baca-saja

Kualifikasi: Unit ("detik")

Waktu yang berlalu, dalam hitungan detik, karena UPS sistem komputer terakhir beralih ke daya baterai, atau jumlah waktu sejak sistem atau UPS terakhir dimulai ulang, mana yang lebih sedikit. Nilai 0 dikembalikan jika baterai "online."

TimeToFullCharge

Jenis data: uint32

Jenis akses: Baca-saja

Kualifikasi: MappingStrings ("MIF. DMTF| Baterai Portabel|002.16"), Unit ("menit")

Sisa waktu, dalam menit, untuk mengisi daya baterai sepenuhnya pada laju pengisian daya saat ini dan gunakan.

Keterangan

Kelas CIM_Battery berasal dari CIM_LogicalDevice.

WMI tidak menerapkan kelas ini. Untuk informasi selengkapnya tentang kelas yang berasal dari CIM_Battery, lihat Kelas Win32.

Dokumentasi ini berasal dari deskripsi kelas CIM yang diterbitkan oleh DMTF. Microsoft mungkin telah membuat perubahan pada kesalahan kecil yang benar, sesuai dengan standar dokumentasi Microsoft SDK, atau memberikan informasi lebih lanjut.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
 Windows Vista
Server minimum yang didukung
 Windows Server 2008
Ruang nama
 Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Lihat juga

CIM_LogicalDevice