OID_PM_ADD_PROTOCOL_OFFLOAD

Artikel
06/15/2023

Sebagai set, driver protokol NDIS menggunakan OID_PM_ADD_PROTOCOL_OFFLOAD OID untuk menambahkan offload protokol untuk manajemen daya ke adaptor jaringan. Anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke struktur NDIS_PM_PROTOCOL_OFFLOAD .

Keterangan

Driver protokol NDIS 6.20 dan yang lebih baru menggunakan OID_PM_ADD_PROTOCOL_OFFLOAD OID untuk menambahkan offload protokol untuk manajemen daya ke adaptor jaringan. Jika permintaan berhasil, adaptor jaringan harus menghasilkan dan mengirimkan paket respons yang diperlukan untuk protokol yang dibongkar ketika adaptor jaringan dalam status daya rendah.

Driver protokol dapat membongkar protokol setelah berhasil mengikat adaptor jaringan yang mendasar dan segera setelah memiliki data yang diperlukan (seperti alamat IP antarmuka) untuk membongkar protokol. Driver protokol juga dapat membongkar protokol sebagai respons terhadap beberapa pemberitahuan peristiwa manajemen daya lainnya, seperti penolakan pola WOL yang ditambahkan sebelumnya atau protokol yang dibongkar.

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 membongkar protokol lain ke adaptor jaringan tersebut. Misalnya, jika driver protokol NDIS mencoba membongkar protokol dalam konteks pemrosesan pemberitahuan peristiwa NetEventSetPower untuk adaptor jaringan tersebut, NDIS akan menggagalkan permintaan.

Sebelum NDIS mengirim permintaan OID ini ke driver NDIS yang mendasar atau menyelesaikan permintaan ke driver yang terlalu berlebihan, NDIS menetapkan anggota ProtocolOffloadId ULONG dari struktur NDIS_PM_PROTOCOL_OFFLOAD ke nilai unik. Driver protokol dan NDIS menggunakan pengidentifikasi offload protokol ini dengan permintaan OID OID_PM_REMOVE_PROTOCOL_OFFLOAD untuk menghapus offload protokol dari adaptor jaringan yang mendasar.

Catatan Pengidentifikasi offload protokol adalah nilai unik untuk setiap offload protokol yang diatur pada adaptor jaringan. Namun, pengidentifikasi offload protokol tidak unik secara global di semua adaptor jaringan.

Jika NDIS atau adaptor jaringan yang mendasar menolak offload, NDIS akan menghasilkan indikasi status NDIS_STATUS_PM_OFFLOAD_REJECTED . Ini dapat terjadi setelah mengembalikan NDIS_STATUS_SUCCESS untuk OID. Anggota StatusBuffer dari struktur NDIS_STATUS_INDICATION berisi pengidentifikasi offload protokol ULONG dari offload protokol yang ditolak.

Untuk informasi tentang bagaimana driver miniport LAN Nirkabel Native 802.11 menggunakan OID ini, lihat Menambahkan dan Menghapus Offload Protokol Daya Rendah.

Driver miniport mengembalikan salah satu kode status berikut untuk permintaan:

NDIS_STATUS_SUCCESS
Offload protokol yang diminta berhasil ditambahkan. Anggota ProtocolOffloadId dari struktur NDIS_PM_PROTOCOL_OFFLOAD berisi pengidentifikasi offload protokol.

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_PM_PROTOCOL_OFFLOAD_LIST_FULL
Permintaan gagal karena daftar offload protokol penuh dan adaptor jaringan tidak dapat menambahkan offload protokol lain.

NDIS_STATUS_RESOURCES
NDIS atau adaptor jaringan yang mendasar tidak dapat menambahkan offload protokol baru karena kurangnya sumber daya.

NDIS_STATUS_INVALID_PARAMETER
Satu atau beberapa parameter dalam struktur NDIS_PM_PROTOCOL_OFFLOAD tidak valid.

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

NDIS_STATUS_NOT_SUPPORTED
Adaptor jaringan tidak mendukung offload protokol yang diminta.

NDIS_STATUS_FAILURE
Permintaan gagal karena alasan selain alasan sebelumnya.