Función StorPortCancelDpc (storport.h)

Artículo
03/05/2024

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.