HW_FREE_ADAPTER_RESOURCES funzione di callback (storport.h)

La routine di callback HwStorFreeAdapterResources consente al driver miniport virtuale Storport di liberare risorse quando viene rimossa la scheda virtuale. Questa è l'ultima routine di callback per l'adapter.

Sintassi

HW_FREE_ADAPTER_RESOURCES HwFreeAdapterResources;

void HwFreeAdapterResources(
  PVOID DeviceExtension
)
{...}

Parametri

DeviceExtension

Puntatore all'area di archiviazione per scheda del driver miniport virtuale.

Valore restituito

nessuno

Osservazioni

Il nome HwStorFreeAdapterResources è il testo segnaposto per il nome di routine effettivo. Il prototipo effettivo di questa routine viene definito in Storport.h come indicato di seguito:

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

Il driver della porta chiama il miniport virtuale HwStorFreeAdapterResources di Storport in PASSIVE_LEVEL.

Esempio

Per definire una funzione di callback HwStorFreeAdapterResources , è innanzitutto necessario fornire una dichiarazione di funzione che identifica il tipo di funzione di callback che si sta definendo. Windows fornisce un set di tipi di funzione di callback per i driver. La dichiarazione di una funzione tramite i tipi di funzione di callback consente di analizzare il codice per i driver, l'SDV ( Static Driver Verifier ) e altri strumenti di verifica di trovare errori ed è un requisito per la scrittura di driver per il sistema operativo Windows.

Ad esempio, per definire una routine di callback HwStorFreeAdapterResources denominata MyHwAdapterFreeResources, usare il tipo HW_FREE_ADAPTER_RESOURCES , come illustrato nell'esempio di codice seguente:

HW_FREE_ADAPTER_RESOURCES MyHwAdapterFreeResources;

Implementare quindi la routine di callback come indicato di seguito:

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

Il tipo di funzione HW_FREE_ADAPTER_RESOURCES è definito nel file di intestazione Storport.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 garantisce che vengano utilizzate le annotazioni applicate al tipo di funzione HW_FREE_ADAPTER_RESOURCES 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 Storport. Per informazioni sulle Use_decl_annotations, vedere Annotazione del comportamento della funzione.

Requisiti