Fonction StorPortCancelDpc (storport.h)
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. |
|
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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | storport.h |