Função StorPortQueueWorkItem (storport.h)
StorPortQueueWorkItem enfileira um item de trabalho do Storport para executar dentro do contexto de um thread de trabalho do sistema (kernel).
Sintaxe
ULONG StorPortQueueWorkItem(
[in] PVOID HwDeviceExtension,
[in] PHW_WORKITEM WorkItemCallback,
[in] PVOID Worker,
[in, optional] PVOID Context
);
Parâmetros
[in] HwDeviceExtension
Um ponteiro para a extensão do dispositivo de hardware para o HBA (adaptador de barramento de host).
[in] WorkItemCallback
Um ponteiro para uma rotina de retorno de chamada de item de trabalho fornecida pelo miniporto. Essa rotina é chamada no contexto do thread do sistema para processar o item de trabalho agendado para o qual o Trabalho aponta.
[in] Worker
Um ponteiro para um buffer opaco para o item de trabalho alocado e inicializado retornado por StorPortInitializeWorker.
[in, optional] Context
Contexto opcional para o Trabalho que é processado pela rotina de retorno de chamada no WorkItemCallback.
Retornar valor
A rotina StorPortQueueWorkItem retorna um destes códigos de status:
| Código de retorno | Descrição |
|---|---|
| STOR_STATUS_BUSY | O item de trabalho já está na fila para processamento. |
| STOR_STATUS_INVALID_DEVICE_STATE | O item de trabalho não pode ser enfileirado, pois o dispositivo está em processo de remoção. |
| STOR_STATUS_INVALID_IRQL | O IRQL atual é maior que DISPATCH_LEVEL. |
| STOR_STATUS_INVALID_PARAMETER | HwDeviceExtension, Worker ou WorkItemCallback é NULL. |
| STOR_STATUS_SUCCESS | O item de trabalho foi enfileirado com êxito. |
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível em Windows 8 e versões posteriores do Windows. |
| Plataforma de Destino | Universal |
| Cabeçalho | storport.h (inclua Storport.h) |
| IRQL | <= DISPATCH_LEVEL |