NdisMCoIndicateStatusEx-Funktion (ndis.h)
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) |