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 miniporto. 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 miniporto imediatamente após o driver de miniporto chamar StorPortInitialize. O driver de porta libera essa memória quando remove o dispositivo. O driver de miniporto 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, comprimento é atualizado para refletir o tamanho real em bytes do buffer que foi alocado.
Valor de retorno
StorPortAllocateRegistryBuffer retorna um ponteiro para o buffer do Registro solicitado pelo chamador ou NULL se algum erro impedir que a memória seja alocada.
Observações
Cada instanciação de um driver de miniporto 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 |
|---|---|
| da Plataforma de Destino | Universal |
| cabeçalho | storport.h (inclua Storport.h) |
| biblioteca | Storport.lib |