Fungsi NdisMCoIndicateStatusEx (ndis.h)

Artikel
02/26/2024

Fungsi NdisMCoIndicateStatusEx melaporkan perubahan status adaptor miniport CoNDIS.

Sintaks

void NdisMCoIndicateStatusEx(
  [in]           NDIS_HANDLE             MiniportAdapterHandle,
  [in, optional] NDIS_HANDLE             NdisVcHandle,
  [in]           PNDIS_STATUS_INDICATION StatusIndication
);

Parameter

[in] MiniportAdapterHandle

Handel adaptor miniport yang diteruskan NDIS pada parameter MiniportAdapterHandle Fungsi MiniportInitializeEx .

[in, optional] NdisVcHandle

Handel yang mengidentifikasi koneksi virtual (VC). Driver miniport memperoleh handel ini sebagai parameter input ke fungsi MiniportCoCreateVc-nya , baik ketika klien menyiapkan panggilan keluar atau ketika manajer panggilan membuat VC untuk titik akses layanan (SAP) yang terdaftar klien. Manajer panggilan membuat VC untuk menunjukkan pemberitahuan panggilan masuk. Untuk mengirim indikasi status ke semua pengikatan protokol, atur parameter ini ke NULL.

[in] StatusIndication

Penunjuk ke struktur NDIS_STATUS_INDICATION yang berisi informasi status.

Nilai kembali

Tidak ada

Keterangan

Ketika driver miniport memanggil NdisMCoIndicateStatusEx dengan handel VC NULL untuk parameter NdisVcHandle , NDIS meneruskan pemberitahuan perubahan status ke semua driver protokol terikat dengan memanggil setiap fungsi ProtocolCoStatusEx driver protokol terikat. Panggilan ke NdisMCoIndicateStatusEx dengan handel VC non-NULL membatasi pemberitahuan status kepada klien atau manajer panggilan yang ditangani driver miniport dengan VC ini.

Driver miniport dapat memanggil NdisMCoIndicateStatusEx setelah mengatur atribut pendaftarannya, dengan memanggil Fungsi NdisMSetMiniportAttributes dari fungsi MiniportInitializeEx-nya , bahkan jika driver masih dalam konteks fungsi MiniportInitializeEx . Driver tidak boleh memanggil NdisMCoIndicateStatusEx setelah kembali dari fungsi MiniportHaltEx .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung di NDIS 6.0 dan yang lebih baru.
Target Platform	Desktop
Header	ndis.h (termasuk Ndis.h)
Pustaka	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Aturan kepatuhan DDI	Irql_MCO_Function(ndis)