Поделиться через


Функция StorPortCancelDpc (storport.h)

StorPortCancelDpc пытается отменить выполнение отложенного вызова процедуры StorPort (DPC).

Синтаксис

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

Параметры

HwDeviceExtension

Указатель на расширение аппаратного устройства для адаптера шины узла (HBA).

Dpc

Указатель на объект DPC STOR_DPC , который требуется отменить.

ReturnValue

Указатель на ЛОГИЧЕСКОЕ ЗНАЧЕНИЕ , в котором эта функция возвращает одно из следующих значений.

Возвращаемое значение Описание
TRUE Указанный DPC успешно удален из очереди DPC системы.
Ложь. Указанный DPC не был удален из очереди DPC системы.

Возвращаемое значение

Эта функция возвращает один из следующих кодов состояния.

Код возврата Описание
STOR_STATUS_INVALID_PARAMETER Dpc или ReturnValue имеют значение NULL.
STOR_STATUS_NOT_IMPLEMENTED
Эта функция не реализована в активной операционной системе.
STOR_STATUS_SUCCESS Эта функция успешно завершена. Используйте значение, возвращаемое в ReturnValue, чтобы определить, удален ли DPC из очереди.

Комментарии

Если указанный DPC StorPort находится в очереди DPC, StorPortCancelDpc удаляет его из очереди, отменяя вызов связанной подпрограммы DPC. Если она отсутствует в очереди, она либо выполнялась, либо была завершена, поэтому ее невозможно удалить.

Эта подпрограмма реализуется с помощью встроенных определений функций, поэтому драйверы мини-портов, использующие ее, не должны связываться с библиотеками, зависящими от версии операционной системы. Драйверы мини-портов могут использовать эту подпрограмму, не жертвуя обратной совместимостью с версиями операционной системы, которые не поддерживают DPC в драйверах мини-портов хранилища.

Требования

Требование Значение
Заголовок storport.h

См. также раздел

STOR_DPC

StorPortInitializeDpc

StorPortIssueDpc