OID_NDK_SET_STATE
Sebagai permintaan yang ditetapkan, NDIS dan driver yang terlalu mengandalkan menggunakan OID_NDK_SET_STATE OID untuk mengatur status fungsionalitas NDK adaptor miniport.
Driver miniport NDIS 6.30 dan yang lebih baru yang menyediakan layanan NDK harus mendukung OID ini. Jika tidak, OID ini bersifat opsional.
Keterangan
NDIS mengeluarkan OID ini dengan anggota InformationBuffer dari struktur NDIS_OID_REQUEST yang menunjuk ke anggota BOOLEAN dan InformationBufferLength sama dengan sizeof(BOOLEAN).
Jika nilai BOOLEANTRUE dan nilai kata kunci *NetworkDirect bukan nol, fungsionalitas NDK adaptor miniport harus diaktifkan.
Driver miniport dapat membaca nilai kata kunci *NetworkDirect dengan melakukan hal berikut:
Panggil NdisOpenConfigurationEx dengan handel NDIS yang dikembalikan fungsi NdisMRegisterMiniportDriver saat driver miniport diinisialisasi. Untuk informasi selengkapnya tentang memanggil NdisOpenConfigurationEx, lihat Membaca Registri di Driver Miniport NDIS 6.0.
Panggil NdisReadConfiguration, melewati:
"*NetworkDirect" untuk parameter Kata Kunci
NdisParameterInteger untuk parameter ParameterType
Jika nilai BOOLEANFALSE, fungsionalitas NDK dari adaptor miniport harus dinonaktifkan.
Untuk mengaktifkan atau menonaktifkan fungsionalitas NDK-nya, fungsi panggilan balik Miniport Driver MiniportOidRequest harus mengikuti langkah-langkah dalam Mengaktifkan dan Menonaktifkan Fungsionalitas NDK.
Catatan Driver miniport berkemampuan NDK tidak boleh memanggil NdisMNetPnPEvent dari konteks fungsi MiniportOidRequest-nya , karena melakukannya dapat menyebabkan kebuntuan. Sebaliknya, ini harus memanggil NdisMNetPnPEvent dari beberapa konteks lain atau mengantre item kerja.
Fungsi MiniportOidRequest driver berkemampuan NDK harus mengembalikan STATUS_SUCCESS untuk permintaan OID OID_NDK_SET_STATE kecuali terjadi kegagalan. Driver tidak boleh mengembalikan NDIS_STATUS_PENDING.
Persyaratan
Klien minimum yang didukung |
Tidak ada yang didukung |
Server minimum yang didukung |
Windows Server 2012 |
Versi |
Didukung di NDIS 6.30 dan yang lebih baru. |
Header |
Ntddndis.h (termasuk Ndis.h) |