Função StorPortInitialize (storport.h)

Artigo
07/16/2024

A rotina StorPortInitialize inicializa os parâmetros do driver de porta e os dados de extensão. StorPortInitialize também salva as informações do adaptador fornecidas na rotinadriver de miniporto DriverEntry.

Sintaxe

STORPORT_API ULONG StorPortInitialize(
  [in]           PVOID                   Argument1,
  [in]           PVOID                   Argument2,
  [in]           _HW_INITIALIZATION_DATA *HwInitializationData,
  [in, optional] PVOID                   HwContext
);

Parâmetros

[in] Argument1

O primeiro ponteiro com o qual o sistema operacional chamou a rotina DriverEntry do miniporto.

[in] Argument2

O segundo ponteiro com o qual o sistema operacional chamou a rotina DriverEntry dos miniportos.

[in] HwInitializationData

Ponteiro para as informações de inicialização e configuração definidas pelo driver de miniporto em sua rotina driverEntry.

[in, optional] HwContext

É o endereço de um valor de contexto a ser passado para a rotina de HwStorFindAdapter do driver de miniport. Somente os drivers de miniporto herdados que verificam o barramento para HBAs em vez de receber informações de configuração do driver de porta podem usar esse parâmetro para armazenar o estado entre chamadas para HwStorFindAdapter.

Valor de retorno

O resultado das ações de inicialização executadas por StorPortInitialize. O driver de miniporto retornará esse valor como o valor retornado para sua rotina driverEntry.

StorPortInitialize retorna um dos seguintes códigos de status:

Código de retorno	Descrição
STATUS_INVALID_PARAMETER	Argument1 é NULL ou Argument2 é NULL, OR HwInitializationData é NULL.
STATUS_SUCCESS	Os dados da extensão de driver e as informações do adaptador foram inicializados com êxito.
STATUS_NO_MEMORY	Nenhuma memória está disponível para armazenar um parâmetro de inicialização.
STATUS_REVISION_MISMATCH	A versão da estrutura apontada pelo HwInitializationData é inválida para o sistema operacional atual.
STATUS_INSUFFICENT_RESOURCES	A alocação falhou para os dados de extensão de objeto do driver.

Observações

Essa rotina deve ser chamada da rotina DriverEntry do driver de miniport.

Como os drivers de miniporto storport devem dar suporte a PnP, o driver Storport não usa o parâmetro HwContext passado para StorPortInitialize.

A rotina DriverEntry de cada driver de miniporto deve chamar StorPortInitialize depois que o driver do miniporto tiver zerado pela primeira vez e, em seguida, definir os membros do HW_INITIALIZATION_DATA.

Requisitos

Requisito	Valor
da Plataforma de Destino	Universal
cabeçalho	storport.h (inclua Storport.h)
biblioteca	Storport.lib

Consulte também

HW_INITIALIZATION_DATA

HwStorFindAdapter

Compartilhar via