Função StorPortRegistryWriteAdapterKey (storport.h)

Artigo
02/07/2025

A rotina StorPortRegistryReadAdapterKey é chamada pelo driver de miniporto para ler as chaves do adaptador de registro de dispositivo ou hardware localizadas no registro em HKLM/CurrentControlSet/Enum/o caminho da instância/DeviceParameters/... essas chaves são lidas na seção INF DDInstall.HW.

Sintaxe

ULONG StorPortRegistryWriteAdapterKey(
  [in]           PVOID  HwDeviceExtension,
  [in, optional] PUCHAR SubKeyName,
  [in]           PUCHAR ValueName,
  [in]           ULONG  ValueType,
  [in, out]      PVOID  ValueData,
  [in, out]      ULONG  ValueDataLength
);

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, optional] SubKeyName

A subchave do miniporto.

[in] ValueName

O nome do Valor sob a chave.

[in] ValueType

Um dos seguintes tipos de dados do Registro.

Tipo	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 recurso.
REG_QWORD	Número de quadlet de 64 bits.
REG_QWORD_LITTLE_ENDIAN	Número de quadlet de 64 bits com um formato little-endian.

[in, out] ValueData

Ponteiro para os dados que contêm os dados do Registro a serem lidos. Os dados são convertidos de UNICODE em uma cadeia de caracteres ASCII terminada em NULL.

[in, out] ValueDataLength

Especifica o tamanho dos dados apontados por ValueData.

Valor de retorno

Retorna STOR_STATUS_SUCCESS quando a operação for bem-sucedida, caso contrário, o código de erro apropriado.

Requisitos

Requisito	Valor
da Plataforma de Destino	Universal
cabeçalho	storport.h (inclua Storport.h)
biblioteca	Storport.lib
IRQL	PASSIVE_LEVEL

Consulte também

StorPortInitialize

Partilhar via