MINIPORT_CO_DELETE_VC funzione di callback (ndis.h)

Articolo
08/07/2023

La funzione MiniportCoDeleteVc è necessaria per i miniport orientati alla connessione. MiniportCoDeleteVc indica che un VC viene rimosso ed eliminato da NDIS.

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

Sintassi

MINIPORT_CO_DELETE_VC MiniportCoDeleteVc;

NDIS_STATUS MiniportCoDeleteVc(
  [in] NDIS_HANDLE MiniportVcContext
)
{...}

Parametri

[in] MiniportVcContext

Specifica l'handle in un'area di contesto allocata dal driver miniport in cui il driver miniport mantiene lo stato per VC. Il driver miniport ha fornito questo handle a NDIS dalla sua funzione MiniportCoCreateVc .

Valore restituito

Codice restituito	Descrizione
NDIS_STATUS_SUCCESS	Indica che il driver miniport ha liberato correttamente tutte le risorse allocate per questo VC.

Commenti

MiniportCoDeleteVcmust viene scritto come funzione sincrona e non può, in qualsiasi caso, restituire NDIS_STATUS_PENDING senza causare un errore a livello di sistema.

MiniportCoDeleteVc libera qualsiasi risorsa allocata su base VC e archiviata nell'area di contesto MiniportVcContext . Il driver miniport deve anche liberare miniportVcContext allocato nella sua funzione MiniportCoCreateVc .

Esempi

Per definire una funzione MiniportCoDeleteVc , è prima 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 usando i tipi di funzione consente l'analisi del codice per i driver, il verifica driver statico (SDV) e altri strumenti di verifica trovano errori ed è un requisito per la scrittura di driver per il sistema operativo Windows.

Ad esempio, per definire una funzione MiniportCoDeleteVc denominata "MyCoDeleteVc ", usare il tipo di MINIPORT_CO_DELETE_VC come illustrato in questo esempio di codice:

MINIPORT_CO_DELETE_VC MyCoDeleteVc;

Implementare quindi la funzione come indicato di seguito:

_Use_decl_annotations_
NDIS_STATUS
 MyCoDeleteVc(
    NDIS_HANDLE  MiniportVcContext
    )
  {...}

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

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

Requisiti

Requisito	Valore
Client minimo supportato	Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere MiniportCoDeleteVc (NDIS 5.1) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere MiniportCoDeleteVc (NDIS 5.1) in Windows XP.
Piattaforma di destinazione	Windows
Intestazione	ndis.h (includere Ndis.h)
IRQL	<= DISPATCH_LEVEL

Vedi anche

MiniportCoCreateVc

Condividi tramite