NdisMCoIndicateStatusEx-Funktion (ndis.h)

Artikel
08/07/2023

Die NdisMCoIndicateStatusEx-Funktion meldet eine Änderung der status eines CoNDIS-Miniportadapters.

Syntax

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

Parameter

[in] MiniportAdapterHandle

Das Miniportadapterhandle, das NDIS am MiniportAdapterHandle-Parameter des MiniportInitializeEx-Funktion .

[in, optional] NdisVcHandle

Ein Handle, das die virtuelle Verbindung (VC) identifiziert. Der Miniporttreiber hat dieses Handle als Eingabeparameter für seine MiniportCoCreateVc-Funktion abgerufen, entweder, wenn ein Client einen ausgehenden Aufruf einrichtet oder wenn der Anrufmanager eine VC für einen clientregistrierten Dienstzugriffspunkt (SAP) erstellt hat. Der Anruf-Manager hat die VC erstellt, um eine Benachrichtigung über eingehende Anrufe anzugeben. Um den status-Hinweis an alle Protokollbindungen zu senden, legen Sie diesen Parameter auf NULL fest.

[in] StatusIndication

Ein Zeiger auf eine NDIS_STATUS_INDICATION-Struktur, die die status Informationen enthält.

Rückgabewert

Keine

Bemerkungen

Wenn ein Miniporttreiber NdisMCoIndicateStatusEx mit einem NULL VC-Handle für den NdisVcHandle-Parameter aufruft, leitet NDIS die status-Change-Benachrichtigung an alle gebundenen Protokolltreiber weiter, indem die ProtocolCoStatusEx-Funktion jedes gebundenen Protokolltreibers aufgerufen wird. Ein Aufruf von NdisMCoIndicateStatusEx mit einem VC-Handle ohne NULL schränkt die status Benachrichtigung an Clients oder Anrufmanager ein, für die der Miniporttreiber dieses VC-Handle gemeinsam verwendet.

Ein Miniporttreiber kann NdisMCoIndicateStatusEx aufrufen, nachdem er seine Registrierungsattribute festgelegt hat, indem er die NdisMSetMiniportAttributes-Funktion aus der MiniportInitializeEx-Funktion , auch wenn sich der Treiber noch im Kontext der MiniportInitializeEx-Funktion befindet. Der Treiber darf NdisMCoIndicateStatusEx nicht aufrufen, nachdem er von der MiniportHaltEx-Funktion zurückgegeben wurde.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.0 und höher.
Zielplattform	Desktop
Kopfzeile	ndis.h (einschließlich Ndis.h)
Bibliothek	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI-Complianceregeln	Irql_MCO_Function(ndis)