Função StorPortAllocateRegistryBuffer (storport.h)

  • Artigo

A rotina StorPortAllocateRegistryBuffer é chamada pelo driver de miniporto para alocar um buffer que pode ser usado para ler e gravar dados do Registro.

Sintaxe

STORPORT_API PUCHAR StorPortAllocateRegistryBuffer(
  [in] PVOID  HwDeviceExtension,
  [in] PULONG Length
);

Parâmetros

[in] HwDeviceExtension

Um ponteiro para a extensão do dispositivo de hardware. Essa é uma área de armazenamento por HBA que o driver de porta aloca e inicializa em nome do driver de miniport. Os drivers de miniporto geralmente armazenam informações específicas do HBA nessa extensão, como o estado do HBA e os intervalos de acesso mapeados para o HBA. Essa área está disponível para o driver de miniporte imediatamente após o driver de miniporto chamar StorPortInitialize. O driver de porta libera essa memória quando remove o dispositivo. O driver de miniporte deve estar em execução no IRQL PASSIVE_LEVEL quando chama essa rotina.

[in] Length

Ponteiro para um longo que indica, na entrada, o comprimento em bytes do buffer do Registro exigido pelo chamador. Na saída, Length é atualizado para refletir o tamanho real em bytes do buffer alocado.

Retornar valor

StorPortAllocateRegistryBuffer retorna um ponteiro para o buffer do Registro solicitado pelo chamador ou NULL se algum erro impedir que a memória seja alocada.

Comentários

Cada instanciação de um driver de miniporte só pode ter um buffer do Registro alocado por vez. Se um driver de miniporto tentar alocar mais de um buffer do Registro, a alocação falhará e StorPortAllocateRegistryBuffer retornará NULL.

Requisitos

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

Confira também

StorPortFreeRegistryBuffer