Share via

OID_NDK_SET_STATE

  • Artikel

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:

    1. 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.

    2. 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)

Lihat juga

NDIS_OID_REQUEST

NdisMNetPnPEvent

NdisQueueIoWorkItem

NdisReadConfiguration

NDK_ADAPTER

OID_NDK_SET_STATE