Función StorPortCancelDpc (storport.h)

  • Artículo

StorPortCancelDpc intenta cancelar la ejecución de una llamada a procedimiento diferido de StorPort (DPC).

Sintaxis

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

Parámetros

HwDeviceExtension

Puntero a la extensión de dispositivo de hardware para el adaptador de bus host (HBA).

Dpc

Puntero al STOR_DPC objeto DPC que se va a cancelar.

ReturnValue

Puntero a un valor BOOLEAN en el que esta función devolverá uno de los valores siguientes.

Valor devuelto Descripción
VERDADERO El Dpc especificado se quitó correctamente de la cola DPC del sistema.
FALSE El Dpc especificado no se quitó de la cola DPC del sistema.

Valor devuelto

Esta función devuelve uno de los siguientes códigos de estado.

Código de retorno Descripción
STOR_STATUS_INVALID_PARAMETER Dpc o ReturnValue son NULL.
STOR_STATUS_NOT_IMPLEMENTED
 Esta función no se implementa en el sistema operativo activo.
STOR_STATUS_SUCCESS Esta función se completó correctamente. Use el valor devuelto en ReturnValue para determinar si el Dpc se quitó de la cola.

Comentarios

Si el DPC de StorPort especificado está en la cola DPC, StorPortCancelDpc lo quita de la cola, cancelando una llamada a la rutina DPC asociada. Si no está en la cola, se estaba ejecutando o había terminado de ejecutarse y, por tanto, no se podía quitar.

Esta rutina se implementa mediante definiciones de función insertadas, por lo que los controladores de miniporte que lo usan no tienen que vincularse a bibliotecas que dependen de la versión del sistema operativo. Los controladores de minipuerto pueden usar esta rutina sin sacrificar la compatibilidad con versiones anteriores del sistema operativo que no admiten DPC en controladores de minipuerto de almacenamiento.

Requisitos

Requisito Valor
Header storport.h

Consulte también

STOR_DPC

StorPortInitializeDpc

StorPortIssueDpc