Функция StorPortQueueWorkItem (storport.h)
StorPortQueueWorkItem очереди рабочего элемента Storport для выполнения в контексте рабочего потока системы (ядра).
Синтаксис
ULONG StorPortQueueWorkItem(
[in] PVOID HwDeviceExtension,
[in] PHW_WORKITEM WorkItemCallback,
[in] PVOID Worker,
[in, optional] PVOID Context
);
Параметры
[in] HwDeviceExtension
Указатель на расширение аппаратного устройства для адаптера шины узла (HBA).
[in] WorkItemCallback
Указатель на подпрограмму обратного вызова рабочего элемента, предоставляемую минипортом. Эта подпрограмма вызывается в контексте системного потока для обработки запланированного рабочего элемента, на который рабочий указывает.
[in] Worker
Указатель на непрозрачный буфер для выделенного и инициализированного рабочего элемента, возвращенного StorPortInitializeWorker.
[in, optional] Context
Необязательный контекст для рабочей, обрабатываемой подпрограммой обратного вызова в WorkItemCallback.
Возвращаемое значение
подпрограмма StorPortQueueWorkItem возвращает один из следующих кодов состояния:
| Возвращаемый код | Описание |
|---|---|
| STOR_STATUS_BUSY | Рабочий элемент уже помещается в очередь для обработки. |
| STOR_STATUS_INVALID_DEVICE_STATE | Рабочий элемент не может быть помещен в очередь, так как устройство находится в процессе удаления. |
| STOR_STATUS_INVALID_IRQL | Текущий IRQL больше DISPATCH_LEVEL. |
| STOR_STATUS_INVALID_PARAMETER | HwDeviceExtension, workerили WorkItemCallback имеет значение NULL. |
| STOR_STATUS_SUCCESS | Рабочий элемент успешно помещен в очередь. |
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Windows 8 и более поздних версиях Windows. |
| целевая платформа | Всеобщий |
| заголовка | storport.h (include Storport.h) |
| IRQL | <= DISPATCH_LEVEL |