Compartilhar via

HW_WORKITEM função de retorno de chamada (storport.h)

  • Artigo

Uma função de retorno de chamada fornecida pelo miniporto para processar uma solicitação de item de trabalho do Storport.

Sintaxe

HW_WORKITEM HwWorkitem;

void HwWorkitem(
  [in]           PVOID HwDeviceExtension,
  [in, optional] PVOID Context,
  [in]           PVOID Worker
)
{...}

Parâmetros

[in] HwDeviceExtension

Um ponteiro para a área de armazenamento por HBA do driver de miniport.

[in, optional] Context

Contexto opcional fornecido pelo miniporto no parâmetro Callback de StorPortQueueWorkItem.

[in] Worker

Um ponteiro para um buffer opaco que contém informações de contexto para o item de trabalho retornado por StorPortInitializeWorker.

Retornar valor

Nenhum

Comentários

Se necessário, um item de trabalho pode ser enfileirado no HwStorWorkItem. Chame StorPortQueueWorkItem com o item de trabalho atual para reutilizá-lo. Caso contrário, chame StorPortFreeWorker para liberar o item de trabalho.

Nenhum bloqueio é adquirido pelo Storport quando o retorno de chamada é invocado. O miniporto é responsável por qualquer sincronização necessária na rotina de retorno de chamada.

O nome HwStorWorkItem é apenas um espaço reservado para a função miniport que é apontada pelo parâmetro Callback de StorPortQueueWorkItem. O protótipo real dessa rotina é definido em Storport.h da seguinte maneira:

typedef
VOID
HW_WORKITEM (
    _In_     PVOID HwDeviceExtension,
    _In_Opt_ PVOID Context,
    _In_     PVOID Worker,
    );

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 PASSIVE_LEVEL

Confira também

StorPortFreeWorker

StorPortInitializeWorker

StorPortQueueWorkItem