Função StorPortAllocateRegistryBuffer (storport.h)
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 |