PROTOCOL_CM_NOTIFY_CLOSE_AF_COMPLETE funzione di callback (ndis.h)

La funzione ProtocolCmNotifyCloseAfComplete indica che un client ha completato la chiusura di una famiglia di indirizzi (AF) avviata da un gestore chiamate autonomo o un gestore chiamate miniport (MCM) chiamando il NdisCmNotifyCloseAddressFamily o Funzione NdisMCmNotifyCloseAddressFamily , rispettivamente.

Nota È necessario dichiarare la funzione usando il tipo di PROTOCOL_CM_NOTIFY_CLOSE_AF_COMPLETE . Per altre informazioni, vedere la sezione Esempi seguente.

 

Sintassi

PROTOCOL_CM_NOTIFY_CLOSE_AF_COMPLETE ProtocolCmNotifyCloseAfComplete;

void ProtocolCmNotifyCloseAfComplete(
  [in] NDIS_HANDLE CallMgrAfContext,
  [in] NDIS_STATUS Status
)
{...}

Parametri

[in] CallMgrAfContext

Handle per l'area di contesto af del gestore chiamate fornita dal gestore chiamate a NDIS nella funzione ProtocolCmOpenAf .

[in] Status

Stato finale dei client per la notifica di chiusura di Af. Lo stato può essere uno dei seguenti:

NDIS_STATUS_SUCCESS

Il client ha chiuso correttamente la famiglia di indirizzi.

NDIS_STATUS_XXX

Il client non ha superato la richiesta per un motivo determinato dal driver.

Valore restituito

nessuno

Osservazioni

La funzione ProtocolCmNotifyCloseAfComplete è necessaria per i gestori chiamate CoNDIS.

Se un gestore chiamate autonomo verrà scollegato da un adattatore miniport sottostante, il gestore chiamate deve chiamare il Funzione NdisCmNotifyCloseAddressFamily prima di annullare l'associazione. Quando un gestore chiamate miniport interrompe un adattatore miniport, mcm deve chiamare il Funzione NdisMCmNotifyCloseAddressFamily .

Se NdisCmNotifyCloseAddressFamily o NdisMCmNotifyCloseAddressFamily restituisce NDIS_STATUS_PENDING, NDIS chiama ProtocolCmNotifyCloseAfComplete dopo che il client completa l'operazione di chiusura af.

NDIS chiama ProtocolCmNotifyCloseAfComplete in IRQL <= DISPATCH_LEVEL.

Esempi

Per definire una funzione ProtocolCmNotifyCloseAfComplete , è innanzitutto necessario fornire una dichiarazione di funzione che identifica il tipo di funzione che si sta definendo. Windows fornisce un set di tipi di funzione per i driver. La dichiarazione di una funzione con i tipi di funzione consente di eseguire l'analisi del codice per i driver, l'SDV ( Static Driver Verifier ) e altri strumenti di verifica rilevano gli errori ed è un requisito per la scrittura dei driver per il sistema operativo Windows.

Ad esempio, per definire una funzione ProtocolCmNotifyCloseAfComplete denominata "MyCmNotifyCloseAfComplete", usare il tipo PROTOCOL_CM_NOTIFY_CLOSE_AF_COMPLETE , come illustrato in questo esempio di codice:

PROTOCOL_CM_NOTIFY_CLOSE_AF_COMPLETE MyCmNotifyCloseAfComplete;

Implementare quindi la funzione come segue:

_Use_decl_annotations_
VOID
 MyCmNotifyCloseAfComplete(
    NDIS_HANDLE  CallMgrAfContext,
    NDIS_STATUS  Status
    )
  {...}

Il tipo di funzione PROTOCOL_CM_NOTIFY_CLOSE_AF_COMPLETE è definito nel file di intestazione Ndis.h. Per identificare in modo più accurato gli errori quando si eseguono gli strumenti di analisi del codice, assicurarsi di aggiungere l'annotazione Use_decl_annotations alla definizione della funzione. L'annotazione Use_decl_annotations assicura che vengano utilizzate le annotazioni applicate al tipo di funzione PROTOCOL_CM_NOTIFY_CLOSE_AF_COMPLETE nel file di intestazione. Per altre informazioni sui requisiti per le dichiarazioni di funzione, vedere Dichiarazione di funzioni tramite tipi di ruolo di funzione per i driver NDIS.

Per informazioni sulle Use_decl_annotations, vedere Annotazione del comportamento della funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Supportato in NDIS 6.0 e versioni successive.
Piattaforma di destinazione	Windows
Intestazione	ndis.h (include Ndis.h)
IRQL	<= DISPATCH_LEVEL

Vedi anche

NdisCmNotifyCloseAddressFamily NdisMCmNotifyCloseAddressFamily

ProtocolCmOpenAf