OID_PM_PARAMETERS
Sebagai kueri, driver protokol dapat menggunakan OID_PM_PARAMETERS OID untuk mengkueri kemampuan perangkat keras manajemen daya adaptor jaringan yang saat ini diaktifkan. Setelah berhasil mengembalikan dari permintaan kueri OID, anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke struktur NDIS_PM_PARAMETERS .
Sebagai set, driver protokol dapat menggunakan OID_PM_PARAMETERS OID untuk mengaktifkan atau menonaktifkan kemampuan perangkat keras adaptor jaringan saat ini. Driver protokol menyediakan penunjuk ke struktur NDIS_PM_PARAMETERS di anggota InformationBuffer dari struktur NDIS_OID_REQUEST .
Keterangan
Dimulai dengan NDIS 6.20, protokol yang terlalu besar dan driver filter menggunakan OID_PM_PARAMETERS untuk mengkueri dan mengatur kemampuan perangkat keras manajemen daya adaptor jaringan yang saat ini diaktifkan.
Ketika driver yang terlalu berlebihan meminta OID_PM_PARAMETERS OID, NDIS menyelesaikan permintaan tanpa meneruskannya ke driver miniport. NDIS menyimpan pengaturan yang diminta dan menggabungkannya dengan pengaturan dari permintaan lain seperti itu. Sebelum NDIS mentransisikan adaptor jaringan ke status daya rendah, NDIS mengirimkan permintaan yang ditetapkan ke driver miniport yang berisi pengaturan gabungan dari semua permintaan yang disimpan NDIS.
Kemampuan yang saat ini diaktifkan dapat menjadi subset dari kemampuan yang didukung perangkat keras. Untuk informasi selengkapnya tentang kemampuan yang didukung perangkat keras, lihat OID_PM_HARDWARE_CAPABILITIES.
Catatan Jika NDIS menetapkan bendera NDIS_PM_SELECTIVE_SUSPEND_ENABLED di anggota WakeUpFlags dari struktur NDIS_PM_PARAMETERS , NDIS mengeluarkan permintaan set OID OID_PM_PARAMETERS langsung ke driver miniport. Ini memungkinkan NDIS untuk melewati pemrosesan oleh driver filter di tumpukan driver jaringan.
NDIS atau driver miniport mengembalikan salah satu kode status berikut untuk permintaan:
NDIS_STATUS_SUCCESS
Permintaan berhasil diselesaikan.
NDIS_STATUS_PENDING
Permintaan tertunda penyelesaiannya. NDIS akan meneruskan kode status akhir dan hasil ke penanganan 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_INVALID_PARAMETER
Permintaan gagal karena mencoba mengaktifkan kemampuan yang tidak didukung adaptor jaringan yang mendasar.
NDIS_STATUS_FAILURE
Permintaan gagal karena alasan selain alasan sebelumnya.
Persyaratan
Versi |
Didukung di NDIS 6.20 dan yang lebih baru. |
Header |
Ntddndis.h (termasuk Ndis.h) |