Função StorPortInitializeWorker (storport.h)

Artigo
02/07/2025

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.

Valor de retorno

A rotina StorPortInitializeWorker retorna um destes códigos de 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.

Observações

O contexto do item de trabalho retornado no parâmetro de TrabalhoStorPortInitializeWorker é 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 ser chamado durante o função HwStorFindAdapter do miniporto para garantir que os recursos estejam disponíveis quando necessário.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Windows 8 e versões posteriores do Windows.
da Plataforma de Destino	Universal
cabeçalho	storport.h (inclua Storport.h)
IRQL	<= DISPATCH_LEVEL

Consulte também

HwStorFindAdapter

StorPortFreeWorker

StorPortQueueWorkItem

Partilhar via