NdisMCoIndicateStatusEx-Funktion (ndis.h)

2025-02-07

Die NdisMCoIndicateStatusEx--Funktion meldet eine Änderung des Status eines CoNDIS-Miniportadapters.

Syntax

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

Parameter

[in] MiniportAdapterHandle

Der Miniportadapterziehpunkt, den NDIS an den MiniportAdapterHandle Parameter des Parameters "MiniportAdapterHandle" übergeben hat 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 Anruf einrichtet oder wenn der Anrufmanager eine VC für einen client registrierten Dienstzugriffspunkt (SAP) erstellt hat. Der Anrufmanager hat die VC erstellt, um eine Benachrichtigung über eingehende Anrufe anzugeben. Um die Statusanzeige an alle Protokollbindungen zu senden, legen Sie diesen Parameter auf NULL-fest.

[in] StatusIndication

Ein Zeiger auf eine NDIS_STATUS_INDICATION Struktur, die die Statusinformationen enthält.

Rückgabewert

Nichts

Bemerkungen

Wenn ein Miniporttreiber NdisMCoIndicateStatusEx mit einem NULL- VC-Handle für den NdisVcHandle--Parameter aufruft, leitet NDIS die Statusänderungsbenachrichtigung an alle gebundenen Protokolltreiber weiter, indem die ProtocolCoStatusEx-Funktion jedes gebundenen Protokolltreibers aufgerufen wird. Ein Aufruf von NdisMCoIndicateStatusEx mit einem Nicht-NULL- VC-Handle schränkt die Statusbenachrichtigung auf Clients oder Anrufmanager ein, für die der Miniporttreiber dieses VC-Handle freigibt.

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

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Unterstützt in NDIS 6.0 und höher.
Zielplattform-	Desktop
Header-	ndis.h (include Ndis.h)
Library	Ndis.lib
IRQL-	<= DISPATCH_LEVEL
DDI-Complianceregeln	Irql_MCO_Function(ndis)