Função StorPortRegistryWriteAdapterKey (storport.h)

  • Artigo

A rotina StorPortRegistryReadAdapterKey é chamada pelo driver de miniport para ler as chaves do adaptador de registro de hardware ou dispositivo localizadas no registro em HKLM/CurrentControlSet/Enum/Instance path/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 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, optional] SubKeyName

A subchave de miniporte.

[in] ValueName

O nome do Valor sob a chave.

[in] ValueType

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, 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.

Retornar valor

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

Requisitos

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

Confira também

StorPortInitialize