Fonction StorPortCancelDpc (storport.h)

Article
02/29/2024

StorPortCancelDpc tente d’annuler l’exécution d’un appel de procédure différée StorPort (DPC).

Syntaxe

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

Paramètres

HwDeviceExtension

Pointeur vers l’extension de périphérique matériel pour l’adaptateur de bus hôte (HBA).

Dpc

Pointeur vers l’objet DPC STOR_DPC à annuler.

ReturnValue

Pointeur vers un BOOLEAN dans lequel cette fonction retourne l’une des valeurs suivantes.

Valeur de retour	Description
TRUE	Le Dpc spécifié a été supprimé de la file d’attente DPC du système.
FALSE	Le Dpc spécifié n’a pas été supprimé de la file d’attente DPC du système.

Valeur retournée

Cette fonction retourne l’un des codes status suivants.

Code de retour	Description
STOR_STATUS_INVALID_PARAMETER	Dpc ou ReturnValue ont la valeur NULL.
STOR_STATUS_NOT_IMPLEMENTED	Cette fonction n’est pas implémentée sur le système d’exploitation actif.
STOR_STATUS_SUCCESS	Cette fonction s’est terminée avec succès. Utilisez la valeur retournée dans ReturnValue pour déterminer si le Dpc a été supprimé de la file d’attente.

Remarques

Si le DPC StorPort spécifié se trouve dans la file d’attente DPC, StorPortCancelDpc le supprime de la file d’attente, annulant un appel à la routine DPC associée. S’il n’est pas dans la file d’attente, il était en cours d’exécution ou avait terminé son exécution et, par conséquent, il n’a pas pu être supprimé.

Cette routine est implémentée à l’aide de définitions de fonction inline, de sorte que les pilotes miniports qui l’utilisent n’aient pas à se lier à des bibliothèques qui dépendent de la version du système d’exploitation. Les pilotes miniport peuvent utiliser cette routine sans sacrifier la compatibilité descendante avec les versions du système d’exploitation qui ne prennent pas en charge les contrôleurs de domaine dans les pilotes miniport de stockage.