Fungsi NdisCloseAdapter (ndis.h)

Catatan NDIS 5. x telah ditolak dan digantikan oleh NDIS 6. x. Untuk pengembangan driver NDIS baru, lihat Driver Jaringan Yang Dimulai dengan Windows Vista. Untuk informasi tentang port NDIS 5. x driver ke NDIS 6. x, lihat Memindahkan Driver NDIS 5.x ke NDIS 6.0.

NdisCloseAdapter merilis pengikatan yang ditetapkan dan sumber daya dialokasikan ketika protokol yang disebut NdisOpenAdapter.

Sintaks

void NdisCloseAdapter(
  [out] PNDIS_STATUS Status,
  [in]  NDIS_HANDLE  NdisBindingHandle
);

Parameter

[out] Status

Penunjuk ke variabel yang disediakan penelepon di mana fungsi ini mengembalikan status operasi penutupan, yang bisa menjadi salah satu nilai berikut:

  • NDIS_STATUS_SUCCESS
    Pengikatan ditutup dan semua sumber daya yang berkaitan dengan pengikatan tersebut telah dirilis.

  • NDIS_STATUS_PENDING
    Permintaan close-adapter sedang ditangani secara asinkron, dan fungsi ProtocolCloseAdapterComplete penelepon akan dipanggil ketika operasi penutupan selesai.

[in] NdisBindingHandle

Menentukan handel yang dikembalikan oleh NdisOpenAdapter yang mengidentifikasi adaptor virtual atau NIC yang akan ditutup.

Nilai kembali

Tidak ada

Keterangan

Nilai yang dikembalikan: Tidak ada

Driver protokol biasanya memanggil NdisCloseAdapter dari fungsi ProtocolUnbindAdapter-nya . Ini juga dapat memanggil NdisCloseAdapter dari fungsi ProtocolBindAdapter-nya , misalnya, jika gagal mengatur nilai OID setelah memanggil NdisOpenAdapter untuk menyiapkan pengikatan.

Segera setelah protokol memanggil NdisCloseAdapter, handel di NdisBindingHandle harus dianggap tidak valid oleh pemanggil. Ini adalah kesalahan pemrograman untuk meneruskan handel ini dalam panggilan berikutnya ke fungsi NdisXxx .

  • Platform target: Universal
  • Versi: Tidak didukung untuk driver NDIS 6.0 di Windows Vista. Gunakan NdisCloseAdapterEx sebagai gantinya. Didukung untuk driver NDIS 5.1 di Windows Vista dan Windows XP.

Persyaratan

Persyaratan Nilai
Header ndis.h (termasuk Ndis.h)
Pustaka Ndis.lib
IRQL PASSIVE_LEVEL

Lihat juga