Share via

OID_PM_CURRENT_CAPABILITIES

  • Artikel

Sebagai kueri, driver yang terlalu berlebihan dapat menggunakan OID_PM_CURRENT_CAPABILITIES OID untuk mengkueri kemampuan manajemen daya adaptor jaringan yang saat ini tersedia. Setelah berhasil mengembalikan dari permintaan kueri OID, anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke struktur NDIS_PM_CAPABILITIES .

Keterangan

NDIS menangani kueri untuk driver miniport. Dimulai dengan NDIS 6.20, driver miniport menyediakan kemampuan perangkat keras manajemen daya selama inisialisasi. Namun, NDIS dapat menyembunyikan beberapa kemampuan dari driver protokol. Misalnya, NDIS mungkin melaporkan kemampuan yang berbeda saat pengguna menonaktifkan beberapa atau semua kemampuan manajemen daya.

Perhatikan bahwa kemampuan manajemen daya saat ini yang dilaporkan NDIS ke driver protokol belum tentu sama dengan kemampuan perangkat keras yang dilaporkan driver miniport ke NDIS.

NDIS melaporkan kemampuan manajemen daya adaptor jaringan yang mendasari driver protokol yang terlalu mengikat di anggota PowerManagementCapabilitiesEx dari struktur NDIS_BIND_PARAMETERS selama operasi pengikatan. Oleh karena itu, driver protokol tidak perlu meminta OID.

NDIS mengeluarkan indikasi status NDIS_STATUS_PM_CAPABILITIES_CHANGE untuk melaporkan perubahan kemampuan manajemen daya yang tersedia untuk driver yang terlalu mendasar.

Jika adaptor jaringan yang mendasar memiliki driver miniport NDIS 6.1 atau yang lebih lama, NDIS menerjemahkan kemampuan manajemen daya adaptor jaringan yang mendasar ke struktur NDIS_PM_CAPABILITIES .

NDIS mengembalikan salah satu kode status berikut untuk permintaan:

NDIS_STATUS_SUCCESS
Permintaan berhasil diselesaikan. InformationBuffer menunjuk ke struktur NDIS_PM_CAPABILITIES.

NDIS_STATUS_PENDING
Permintaan tertunda penyelesaiannya. NDIS akan meneruskan kode status akhir dan hasil ke penangan penyelesaian permintaan OID dari pemanggil setelah permintaan selesai.

NDIS_STATUS_BUFFER_TOO_SHORT
Buffer informasi terlalu pendek. NDIS mengatur DATA. QUERY_INFORMATION. Anggota BytesNeeded dalam struktur NDIS_OID_REQUEST ke ukuran buffer minimum yang diperlukan.

NDIS_STATUS_FAILURE
Permintaan gagal karena alasan selain alasan sebelumnya.

Persyaratan

Versi

Didukung di NDIS 6.20 dan yang lebih baru. Tidak diminta untuk driver miniport. (Lihat bagian Keterangan.)

Header

 Ntddndis.h (termasuk Ndis.h)

Lihat juga

NDIS_BIND_PARAMETERS

NDIS_OID_REQUEST

NDIS_PM_CAPABILITIES

NDIS_STATUS_PM_CAPABILITIES_CHANGE