Função StorPortInitialize (storport.h)

  • Artigo

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