Função StorPortInitializeWorker (storport.h)

  • Artigo

Cria um novo item de trabalho do Storport que é executado em um thread de trabalho do sistema.

Sintaxe

ULONG StorPortInitializeWorker(
  [in]  PVOID HwDeviceExtension,
  [out] PVOID *Worker
);

Parâmetros

[in] HwDeviceExtension

Um ponteiro para a extensão do dispositivo de hardware para o HBA (adaptador de barramento de host).

[out] Worker

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

Retornar valor

A rotina StorPortInitializeWorker retorna um destes códigos status:

Código de retorno Descrição
STOR_STATUS_INVALID_IRQL
 > DISPATCH_LEVEL IRQL atual.
STOR_STATUS_INVALID_PARAMETER
 HwDeviceExtension ou Worker é NULL.
STOR_STATUS_INSUFFICIENT_RESOURCES
 Recursos insuficientes estão disponíveis para inicializar o contexto do item de trabalho.
STOR_STATUS_SUCCESS
 O item de trabalho foi inicializado com êxito.

Comentários

O contexto do item de trabalho retornado no parâmetro Worker por StorPortInitializeWorker é usado em chamadas futuras para StorPortQueueWorkItem ou StorPortFreeWorker.

Se o miniporto usar o item de trabalho durante o processamento de E/S, recomendamos que StorPortInitializeWorker seja chamado durante a função HwStorFindAdapter do miniport para garantir que os recursos estejam disponíveis quando necessário.

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

Confira também

HwStorFindAdapter

StorPortFreeWorker

StorPortQueueWorkItem