Função StorPortRegistryWrite (storport.h)

Artigo
08/07/2023

A rotina StorPortRegistryWrite é chamada pelo driver de miniporto para converter os dados do Registro contidos em um buffer especificado de ASCII para Unicode e gravar os dados na área de armazenamento por HBA do driver de miniport.

Sintaxe

STORPORT_API BOOLEAN StorPortRegistryWrite(
  [in] PVOID  HwDeviceExtension,
  [in] PUCHAR ValueName,
  [in] ULONG  Global,
  [in] ULONG  Type,
  [in] PUCHAR Buffer,
  [in] ULONG  BufferLength
);

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 miniporta. Os drivers de miniporta 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 miniporta imediatamente após o driver de miniporto chamar StorPortInitialize. O driver de porta libera essa memória quando remove o dispositivo. O driver de miniporta deve estar em execução no IRQL PASSIVE_LEVEL quando chama essa rotina.

[in] ValueName

Ponteiro para uma cadeia de caracteres que especifica o nome do valor.

[in] Global

Indica se a operação deve ser específica do adaptador ou relacionada a todos os adaptadores.

[in] Type

Um dos seguintes tipos de dados do Registro.

Type	Significado
REG_SZ	Cadeia de caracteres terminada em nulo Unicode.
REG_EXPAND_SZ	Cadeia de caracteres terminada em nulo Unicode com referências de variável de ambiente.
REG_BINARY	Dados binários.
REG_DWORD	Palavra dupla de 32 bits.
REG_DWORD_LITTLE_ENDIAN	Palavra dupla de 32 bits com um formato little-endian.
REG_DWORD_BIG_ENDIAN	Palavra dupla de 32 bits com um formato big-endian.
REG_LINK	Cadeia de caracteres Unicode que especifica um link simbólico.
REG_MULTI_SZ	Várias cadeias de caracteres Unicode.
REG_RESOURCE_LIST	Lista de recursos no mapa de recursos.
REG_FULL_RESOURCE_DESCRIPTOR	Lista de recursos na descrição do hardware.
REG_RESOURCE_REQUIREMENTS_LIST	Lista de requisitos de recursos.
REG_QWORD	Número do quadlet de 64 bits.
REG_QWORD_LITTLE_ENDIAN	Número de quadlet de 64 bits com um formato little-endian.

[in] Buffer

Ponteiro para um buffer que contém os dados do Registro a serem gravados.

[in] BufferLength

Especifica o tamanho do buffer apontado pelo Buffer.

Retornar valor

StorPortRegistryWrite retornará um valor booliano de TRUE se os dados do Registro tiverem sido convertidos e gravados com êxito; caso contrário, essa rotina retornará FALSE.

Requisitos

Requisito	Valor
Plataforma de Destino	Universal
Cabeçalho	storport.h (inclua Storport.h)
Biblioteca	Storport.lib
IRQL	PASSIVE_LEVEL
Regras de conformidade da DDI	StorPortIrql(storport)

Confira também

StorPortInitialize

Compartilhar via