HW_COMPLETE_SERVICE_IRP funzione di callback (storport.h)

  • Articolo

La routine HwStorCompleteServiceIrp viene chiamata quando la scheda virtuale viene rimossa. In questo caso, il miniport virtuale Storport può completare qualsiasi ir di callback inverso ricevuto in HwStorCompleteServiceIrp.

Sintassi

HW_COMPLETE_SERVICE_IRP HwCompleteServiceIrp;

void HwCompleteServiceIrp(
  PVOID DeviceExtension
)
{...}

Parametri

DeviceExtension

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

Valore restituito

nessuno

Osservazioni

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

typedef
VOID
HW_COMPLETE_SERVICE_IRP (
  _In_ PVOID  DeviceExtension
  );

Il driver della porta chiama la routine HwStorCompleteServiceIrpdel driver virtuale Storport in PASSIVE_LEVEL senza contenere blocchi di rotazione. Il driver miniport virtuale completa l'IRP chiamando la routine HwStorCompleteServiceIrp .

Esempio

Per definire una funzione di callback HwStorCompleteServiceIrp , è 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 HwStorCompleteServiceIrp denominata *&MyHwCompleteServiceIrp, usare il tipo HW_COMPLETE_SERVICE_IRP, come illustrato in questo esempio di codice:

HW_COMPLETE_SERVICE_IRP MyHwCompleteServiceIrp;

Implementare quindi la routine di callback come indicato di seguito:

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

Il tipo di funzione HW_COMPLETE_SERVICE_IRP è 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_COMPLETE_SERVICE_IRP 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)

Vedi anche

HwStorProcessServiceRequest

StorPortCompleteServiceIrp