Função StorPortRegistryReadAdapterKey (storport.h)
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 StorPortRegistryReadAdapterKey(
[in] PVOID HwDeviceExtension,
[in, optional] PUCHAR SubKeyName,
[in] PUCHAR ValueName,
[in] ULONG ValueType,
[in, out] PVOID *ValueData,
[in, out] PULONG 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 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, optional] SubKeyName
A subchave miniport.
[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
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de