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 rotina DriverEntry do driver de miniport.

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 miniport.

[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 miniporta em sua rotina DriverEntry.

[in, optional] HwContext

É o endereço de um valor de contexto a ser passado para a rotina HwStorFindAdapter do driver de miniport. Somente drivers de miniporta herdados que examinam 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.

Retornar valor

O resultado das ações de inicialização executadas pelo StorPortInitialize. O driver de miniporta 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 Não há memória disponível para armazenar um parâmetro de inicialização.
STATUS_REVISION_MISMATCH A versão da estrutura apontada por 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.

Comentários

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 miniport deve chamar StorPortInitialize depois que o driver de miniporto tiver zero e, em seguida, definir os membros de HW_INITIALIZATION_DATA.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Cabeçalho storport.h (inclua Storport.h)
Biblioteca Storport.lib

Confira também

HW_INITIALIZATION_DATA

HwStorFindAdapter