StorPortCancelDpc, fonction (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 une BOOLEAN dans laquelle cette fonction retourne l’une des valeurs suivantes.
| Valeur de retour | Description |
|---|---|
| VRAI | Le Dpc spécifié a été supprimé de la file d’attente DPC du système. |
| FAUX | Le Dpc spécifié n’a pas été supprimé de la file d’attente DPC du système. |
Valeur de retour
Cette fonction retourne l’un des codes d’état suivants.
| Retour du code | Description |
|---|---|
| STOR_STATUS_INVALID_PARAMETER | Dpc ou ReturnValue sont 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 la Dpc a été supprimée 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, en annulant un appel à la routine DPC associée. S’il n’est pas dans la file d’attente, il s’exécutait ou avait terminé l’exécution, et ne pouvait donc pas être supprimé.
Cette routine est implémentée à l’aide de définitions de fonction inline, afin que les pilotes miniports qui l’utilisent n’aient pas à établir de lien vers 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.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | storport.h |