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

Статья
02/07/2025

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

Синтаксис

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

Параметры

HwDeviceExtension

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

Dpc

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

ReturnValue

Указатель на BOOLEAN, в которой эта функция вернет одно из следующих значений.

Возвращаемое значение	Описание
ИСТИННЫЙ	Указанный 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. Если он не находится в очереди, он либо выполнялся, либо завершил выполнение, и поэтому не удалось удалить.

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

Требования

Требование	Ценность
заголовка	storport.h

См. также

STOR_DPC

StorPortInitializeDpc

StorPortIssueDpc

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