HW_ADAPTER_CONTROL funzione di callback (storport.h)

La routine HwStorAdapterControl di un driver miniport viene chiamata per eseguire operazioni sincrone per controllare lo stato o il comportamento di un adattatore, ad esempio arrestare o riavviare l'adattatore del bus host (HBA) per la gestione della potenza.

Sintassi

HW_ADAPTER_CONTROL HwAdapterControl;

SCSI_ADAPTER_CONTROL_STATUS HwAdapterControl(
  [in] PVOID DeviceExtension,
  [in] SCSI_ADAPTER_CONTROL_TYPE ControlType,
  [in] PVOID Parameters
)
{...}

Parametri

[in] DeviceExtension

Puntatore all'area di archiviazione del driver miniport.

[in] ControlType

Valore SCSI_ADAPTER_CONTROL_TYPE che specifica un'operazione di controllo adattatore, in cui ogni tipo di controllo avvia un'azione dal driver miniport. Per informazioni dettagliate, vedere SCSI_ADAPTER_CONTROL_TYPE .

[in] Parameters

Puntatore a una struttura o a un valore che contiene informazioni correlate al ControlType o NULL se il tipo di controllo non usa una struttura. Tutte le strutture sono allocate dal chiamante. Per informazioni dettagliate, vedere SCSI_ADAPTER_CONTROL_TYPE .

Valore restituito

A seconda del tipo di controllo, HwStorAdapterControl restituisce uno dei valori di SCSI_ADAPTER_CONTROL_STATUS seguenti:

Commenti

HwStorAdapterControl è una funzione obbligatoria.

Storport chiama HwStorAdapterControl di un miniport con un tipo di controllo SCSIQuerySupportedControlTypes dopo l'inizializzazione dell'HBA, ma prima del primo I/O. Il driver miniport riempie la struttura SCSI_SUPPORTED_CONTROL_TYPE_LIST in Parametri con le operazioni supportate. Dopo aver restituito HwStorAdapterControl da questa chiamata, il driver Storport chiama il callback HwStorAdapterControl del driver miniport solo per le operazioni supportate dal miniport.

Poiché i driver miniport che funzionano con il driver Storport devono supportare Plug and Play (PnP), i miniport devono supportare i tipi di controllo SCSIStopAdapter e SCSIRestartAdapter.

La tabella seguente elenca l'oggetto IRQL corrente e lo spinlock acquisito al momento dell'emissione del tipo di controllo.

Il nome HwStorAdapterControl è solo un segnaposto. Il prototipo effettivo di questa routine è definito in storport.h come segue:

typedef
SCSI_ADAPTER_CONTROL_STATUS
HW_ADAPTER_CONTROL (
  _In_ PVOID  DeviceExtension,
  _In_ SCSI_ADAPTER_CONTROL_TYPE  ControlType,
  _In_ PVOID  Parameters
  );

Esempio

Per definire una funzione di callback HwStorAdapterControl , è 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 HwStorAdapterControl denominata MyHwAdapterControl, usare il tipo di HW_ADAPTER_CONTROL come illustrato in questo esempio di codice:

HW_ADAPTER_CONTROL MyHwAdapterControl;

Implementare quindi la routine di callback come indicato di seguito:

_Use_decl_annotations_
SCSI_ADAPTER_CONTROL_STATUS
MyHwAdapterControl (
  _In_ PVOID  DeviceExtension,
  _In_ SCSI_ADAPTER_CONTROL_TYPE  ControlType,
  _In_ PVOID  Parameters
  );
  {
      ...
  }

Il tipo di funzione HW_ADAPTER_CONTROL è 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_ADAPTER_CONTROL 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

Vedi anche

HwStorFindAdapter

HwStorInitialize

HwStorUnitControl

SCSI_ADAPTER_CONTROL_TYPE

SCSI_SUPPORTED_CONTROL_TYPE_LIST