Funzione StorPortCancelDpc (storport.h)

Articolo
02/29/2024

StorPortCancelDpc tenta di annullare l'esecuzione di una chiamata di routine posticipata storPort (DPC).

Sintassi

ULONG StorPortCancelDpc(
  PVOID     HwDeviceExtension,
  PSTOR_DPC Dpc,
  BOOLEAN   *ReturnValue
);

Parametri

HwDeviceExtension

Puntatore all'estensione del dispositivo hardware per l'adattatore del bus host (HBA).

Dpc

Puntatore all'oggetto STOR_DPC DPC da annullare.

ReturnValue

Puntatore a un valore BOOLEAN in cui questa funzione restituirà uno dei valori seguenti.

Valore restituito	Descrizione
true	Il Dpc specificato è stato rimosso correttamente dalla coda DPC del sistema.
FALSE	Il Dpc specificato non è stato rimosso dalla coda DPC del sistema.

Valore restituito

Questa funzione restituisce uno dei codici di stato seguenti.

Codice restituito	Descrizione
STOR_STATUS_INVALID_PARAMETER	Dpc o ReturnValue sono NULL.
STOR_STATUS_NOT_IMPLEMENTED	Questa funzione non viene implementata nel sistema operativo attivo.
STOR_STATUS_SUCCESS	Questa funzione è stata completata correttamente. Usare il valore restituito in ReturnValue per determinare se il Dpc è stato rimosso dalla coda.

Commenti

Se il DPC StorPort specificato si trova nella coda DPC, StorPortCancelDpc lo rimuove dalla coda, annullando una chiamata alla routine DPC associata. Se non si trova nella coda, è stato eseguito o è stato completato l'esecuzione e pertanto non è stato possibile rimuovere.

Questa routine viene implementata usando le definizioni di funzioni inline, in modo che i driver miniport che lo usano non devono collegare alle librerie dipendenti dalla versione del sistema operativo. I driver miniport possono usare questa routine senza sacrificare la compatibilità con le versioni del sistema operativo che non supportano i controller di rete nei driver miniport di archiviazione.