OID_PM_REMOVE_PROTOCOL_OFFLOAD

Artikel
06/15/2023

Sebagai permintaan yang ditetapkan, NDIS dan driver protokol menggunakan OID_PM_REMOVE_PROTOCOL_OFFLOAD OID untuk menghapus offload protokol manajemen daya dari adaptor jaringan. Anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke pengidentifikasi offload protokol ULONG .

Keterangan

Driver NDIS dan protokol menggunakan OID_PM_REMOVE_PROTOCOL_OFFLOAD OID untuk menghapus offload protokol dari adaptor jaringan yang mendasar.

DATA. SET_INFORMATION. Anggota InformationBuffer dari struktur NDIS_OID_REQUEST harus menunjuk ke nilai ULONG untuk pengidentifikasi offload protokol yang ditambahkan sebelumnya. NDIS mengatur pengidentifikasi offload protokol ini di anggota ProtocolOffloadId dari struktur NDIS_PM_PROTOCOL_OFFLOAD ketika NDIS mengirim permintaan OID OID_PM_ADD_PROTOCOL_OFFLOAD sebelumnya ke adaptor jaringan yang mendasar.

Keterangan untuk penulis driver miniport

NDIS memastikan bahwa ukuran buffer setidaknya sizeof (ULONG) dan berisi ID offload protokol yang valid. Oleh karena itu, fungsi MiniportOidRequest driver miniport harus mengembalikan NDIS_STATUS_SUCCESS untuk permintaan ini.

Catatan Jika driver miniport direset, fungsi MiniportOidRequest-nya harus mengembalikan NDIS_STATUS_NOT_ACCEPTED.

Mengembalikan kode status

NDIS mengembalikan salah satu kode status berikut untuk permintaan ini:

NDIS_STATUS_SUCCESS
Offload protokol berhasil dihapus.

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_INVALID_LENGTH
Buffer informasi terlalu kecil. NDIS mengatur DATA. SET_INFORMATION. Anggota BytesNeeded dalam struktur NDIS_OID_REQUEST ke ukuran buffer minimum yang diperlukan, dalam byte.

NDIS_STATUS_FILE_NOT_FOUND
Pengidentifikasi offload protokol dalam permintaan OID tidak valid.