HW_FREE_ADAPTER_RESOURCES función de devolución de llamada (storport.h)

La rutina de devolución de llamada HwStorFreeAdapterResources permite que el controlador miniport virtual storport libere recursos cuando se quita el adaptador virtual. Esta es la última rutina de devolución de llamada para el adaptador.

Sintaxis

HW_FREE_ADAPTER_RESOURCES HwFreeAdapterResources;

void HwFreeAdapterResources(
  PVOID DeviceExtension
)
{...}

Parámetros

DeviceExtension

Puntero al área de almacenamiento del controlador de minipuerto virtual por adaptador.

Valor devuelto

None

Observaciones

El nombre HwStorFreeAdapterResources es texto de marcador de posición para el nombre de rutina real. El prototipo real de esta rutina se define en Storport.h de la siguiente manera:

typedef
VOID
(*PHW_FREE_ADAPTER_RESOURCES) (
  IN PVOID  DeviceExtension
  );

El controlador de puerto llama a los recursos HwStorFreeAdapterResources del miniport virtual storport en PASSIVE_LEVEL.

Ejemplos

Para definir una función de devolución de llamada HwStorFreeAdapterResources , primero debe proporcionar una declaración de función que identifique el tipo de función de devolución de llamada que está definiendo. Windows proporciona un conjunto de tipos de función de devolución de llamada para controladores. Declarar una función mediante los tipos de función de devolución de llamada ayuda a Análisis de código para controladores, Comprobador de controladores estáticos (SDV) y otras herramientas de comprobación encuentran errores y es un requisito para escribir controladores para el sistema operativo Windows.

Por ejemplo, para definir una rutina de devolución de llamada HwStorFreeAdapterResources denominada MyHwAdapterFreeResources, use el tipo de HW_FREE_ADAPTER_RESOURCES como se muestra en este ejemplo de código:

HW_FREE_ADAPTER_RESOURCES MyHwAdapterFreeResources;

A continuación, implemente la rutina de devolución de llamada de la siguiente manera:

_Use_decl_annotations_
VOID
MyHwAdapterFreeResources (
  _In_ PVOID  DeviceExtension
  );
  {
      ...
  }

El tipo de función HW_FREE_ADAPTER_RESOURCES se define en el archivo de encabezado Storport.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 HW_FREE_ADAPTER_RESOURCES en el archivo de encabezado. Para obtener más información sobre los requisitos de las declaraciones de función, consulte Declaración de funciones mediante tipos de rol de función para controladores de Storport. Para obtener información sobre Use_decl_annotations, consulte Anotación del comportamiento de la función.

Requisitos