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

Статья
02/29/2024

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 в драйверах мини-портов хранилища.