Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Sebagai set, driver protokol NDIS menggunakan OID_PM_ADD_WOL_PATTERN OID untuk menambahkan pola wake-on-LAN manajemen daya ke adaptor jaringan. InformationBuffer anggota struktur NDIS_OID_REQUEST berisi penunjuk ke struktur NDIS_PM_WOL_PATTERN.
Komentar
Driver protokol NDIS 6.20 dan yang lebih baru menggunakan OID_PM_ADD_WOL_PATTERN untuk menambahkan pola Wake on LAN (WOL) ke adaptor jaringan. Permintaan OID berisi kriteria bahwa adaptor jaringan harus dibandingkan dengan paket masuk ketika berada dalam status daya rendah. Adaptor jaringan harus menghasilkan peristiwa bangun ketika menerima paket yang cocok dengan kriteria pola.
Driver protokol dapat menambahkan pola WOL setelah berhasil mengikat ke adaptor jaringan yang mendasar dan segera setelah memiliki data yang diperlukan (seperti alamat IP antarmuka) untuk mengatur pola WOL. Driver protokol juga dapat menambahkan pola WOL sebagai respons terhadap beberapa pemberitahuan peristiwa manajemen daya lainnya seperti penolakan pola WOL yang ditambahkan sebelumnya atau protokol offload.
Untuk menghindari kondisi balapan di NDIS dan driver protokol lain yang terikat ke adaptor miniport yang sama, setelah NDIS mulai mengatur adaptor jaringan ke status daya rendah, itu akan gagal setiap upaya untuk menambahkan pola bangun baru ke adaptor jaringan tersebut. Misalnya, jika driver protokol NDIS mencoba menambahkan pola WOL baru dalam konteks pemrosesan pemberitahuan peristiwa NetEventSetPower untuk adaptor jaringan tersebut, NDIS akan gagal permintaan.
Sebelum NDIS mengirim permintaan OID ini ke driver NDIS yang mendasar atau melengkapi permintaan ke driver yang terlalu mengandalkan, NDIS mengatur ULONG PatternId anggota struktur NDIS_PM_WOL_PATTERN ke nilai unik. Driver protokol dan NDIS menggunakan pengidentifikasi pola ini dengan permintaan OID OID_PM_REMOVE_WOL_PATTERN untuk menghapus pola WOL dari adaptor jaringan yang mendasar.
Catatan Pengidentifikasi pola adalah nilai unik untuk setiap pola yang diatur pada adaptor jaringan. Namun, pengidentifikasi pola tidak unik secara global di semua adaptor miniport.
Jika NDIS atau adaptor jaringan yang mendasar menghapus pola WOL, maka akan menghasilkan indikasi status NDIS_STATUS_PM_WOL_PATTERN_REJECTED. StatusBuffer anggota struktur NDIS_STATUS_INDICATION berisi pengidentifikasi pola WOL ULONG dari pola WOL yang ditolak.
Driver miniport mengembalikan salah satu kode status berikut untuk permintaan:
NDIS_STATUS_SUCCESS
Pola yang diminta berhasil ditambahkan. Anggota PatternId struktur NDIS_PM_WOL_PATTERN berisi pengidentifikasi pola.
NDIS_STATUS_PENDING
Permintaan tertunda penyelesaiannya. NDIS akan meneruskan kode status akhir dan hasil ke penanganan penyelesaian permintaan OID pemanggil setelah permintaan selesai.
NDIS_STATUS_PM_WOL_PATTERN_LIST_FULL
Permintaan gagal karena daftar pola penuh dan adaptor jaringan tidak dapat menambahkan pola lain.
NDIS_STATUS_RESOURCES
NDIS atau adaptor jaringan yang mendasar tidak dapat menambahkan pola baru karena kurangnya sumber daya.
NDIS_STATUS_INVALID_PARAMETER
Satu atau beberapa parameter dalam struktur NDIS_PM_WOL_PATTERN tidak valid.
NDIS_STATUS_BUFFER_TOO_SHORT
Buffer informasi terlalu pendek. NDIS mengatur DATA . SET_INFORMATION. BytesNeeded anggota dalam struktur NDIS_OID_REQUEST ke ukuran buffer minimum yang diperlukan.
NDIS_STATUS_NOT_SUPPORTED
Adaptor jaringan tidak mendukung pola WOL yang diminta.
NDIS_STATUS_FAILURE
Permintaan gagal karena alasan selain alasan sebelumnya.
Persyaratan
Versi |
Didukung di NDIS 6.20 dan yang lebih baru. Wajib untuk driver miniport. |
Header |
Ntddndis.h (termasuk Ndis.h) |