MINIPORT_CO_DELETE_VC función de devolución de llamada (ndis.h)

La función MiniportCoDeleteVc es necesaria para miniportes orientados a la conexión. MiniportCoDeleteVc indica que una credencial verificable se está eliminando y eliminando por NDIS.

Nota Debe declarar la función mediante el tipo MINIPORT_CO_DELETE_VC . Para obtener más información, consulte la sección Ejemplos siguientes.

 

Sintaxis

MINIPORT_CO_DELETE_VC MiniportCoDeleteVc;

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

Parámetros

[in] MiniportVcContext

Especifica el identificador de un área de contexto asignada por el controlador de miniporte en la que el controlador de miniporte mantiene su estado por VC. El controlador de minipuerto proporcionó este identificador a NDIS desde su función MiniportCoCreateVc .

Valor devuelto

Código devuelto	Descripción
NDIS_STATUS_SUCCESS	Indica que el controlador de minipuerto liberó correctamente todos los recursos asignados para esta credencial verificable.

Comentarios

MiniportCoDeleteVcmust se escribe como una función sincrónica y no puede, en ninguna circunstancia, devolver NDIS_STATUS_PENDING sin causar un error en todo el sistema.

MiniportCoDeleteVc libera todos los recursos asignados por VC y almacenados en el área de contexto MiniportVcContext . El controlador de minipuerto también debe liberar el MiniportVcContext asignado en su función MiniportCoCreateVc .

Ejemplos

Para definir una función MiniportCoDeleteVc , primero debe proporcionar una declaración de función que identifique el tipo de función que está definiendo. Windows proporciona un conjunto de tipos de función para controladores. Declarar una función mediante los tipos de función ayuda a Code Analysis for Drivers, Static Driver Verifier (SDV) y otras herramientas de comprobación a encontrar errores y es un requisito para escribir controladores para el sistema operativo Windows.

Por ejemplo, para definir una función MiniportCoDeleteVc denominada "MyCoDeleteVc", use el tipo de MINIPORT_CO_DELETE_VC como se muestra en este ejemplo de código:

MINIPORT_CO_DELETE_VC MyCoDeleteVc;

A continuación, implemente la función de la siguiente manera:

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

El tipo de función MINIPORT_CO_DELETE_VC se define en el archivo de encabezado Ndis.h. Para identificar con más precisión los errores al ejecutar las herramientas de análisis de código, asegúrese de agregar la anotación Use_decl_annotations a la definición de función. La anotación Use_decl_annotations garantiza que se usen las anotaciones que se aplican al tipo de función MINIPORT_CO_DELETE_VC en el archivo de encabezado. Para obtener más información sobre los requisitos de las declaraciones de función, vea Declarar funciones mediante tipos de roles de función para controladores NDIS.

Para obtener información sobre Use_decl_annotations, consulte Anotación del comportamiento de la función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Compatible con controladores NDIS 6.0 y NDIS 5.1 (consulte MiniportCoDeleteVc (NDIS 5.1)) en Windows Vista. Compatible con controladores NDIS 5.1 (consulta MiniportCoDeleteVc (NDIS 5.1)) en Windows XP.
Plataforma de destino	Windows
Encabezado	ndis.h (incluya Ndis.h)
IRQL	<= DISPATCH_LEVEL

Consulte también

MiniportCoCreateVc