HW_INITIALIZE_TRACING funzione di callback (storport.h)

  • Articolo

La routine di callback HwStorInitializeTracing consente al driver miniport virtuale Storport di configurare la traccia e le risorse correlate.

Sintassi

HW_INITIALIZE_TRACING HwInitializeTracing;

void HwInitializeTracing(
  PVOID Arg1,
  PVOID Arg2
)
{...}

Parametri

Arg1

Primo parametro passato a StorPortInitialize.

Arg2

Secondo parametro passato a StorPortInitialize.

Valore restituito

nessuno

Osservazioni

Il nome HwStorInitializeTracing è il testo segnaposto per il nome di routine effettivo. Il prototipo effettivo di questa routine è definito in Storport.h come segue:

typedef
VOID
HW_INITIALIZE_TRACING (
  _In_ PVOID  Arg1,
  _In_ PVOID  Arg2
  );

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

Esempio

Per definire una funzione di callback HwStorInitializeTracing , è prima necessario specificare 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 usando i tipi di funzione callback 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 routine di callback HwStorInitializeTracing denominata MyHwInitializeTracing, usare il tipo di HW_INITIALIZE_TRACING come illustrato in questo esempio di codice:

HW_INITIALIZE_TRACING MyHwInitializeTracing;

Implementare quindi la routine di callback come indicato di seguito:

_Use_decl_annotations_
VOID
MyHwInitializeTracing (
  _In_ PVOID  Arg1,
  _In_ PVOID  Arg2
  );
  {
      ...
  }

Il tipo di funzione HW_INITIALIZE_TRACING è definito nel file di intestazione Storport.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 HW_INITIALIZE_TRACING 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 su Use_decl_annotations, vedere Annotazione del comportamento della funzione.

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Intestazione Storport.h (include Storport.h)