Función StorPortRegistryReadAdapterKey (storport.h)

El controlador de miniporta llama a la rutina StorPortRegistryReadAdapterKey para leer las claves del adaptador del registro de hardware o dispositivo ubicadas en el Registro en HKLM/CurrentControlSet/Enum/Ruta de acceso de instancia/DeviceParameters/... estas claves se leen en la sección INF DDInstall.HW.

Sintaxis

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

Puntero a la extensión de dispositivo de hardware. Se trata de un área de almacenamiento por HBA que el controlador de puerto asigna e inicializa en nombre del controlador de minipuerto. Los controladores de minipuerto suelen almacenar información específica de HBA en esta extensión, como el estado del HBA y los intervalos de acceso asignados para el HBA. Esta área está disponible para el controlador de minipuerto inmediatamente después de que el controlador de minipuerto llame a StorPortInitialize. El controlador de puerto libera esta memoria cuando quita el dispositivo. El controlador de minipuerto debe ejecutarse en IRQL PASSIVE_LEVEL cuando llama a esta rutina.

[in, optional] SubKeyName

Subclave de minipuerto.

[in] ValueName

Nombre del valor en la clave.

[in] ValueType

Uno de los siguientes tipos de datos del Registro.

Tipo	Significado
REG_SZ	Cadena terminada en null unicode.
REG_EXPAND_SZ	Cadena terminada en null unicode con referencias a variables de entorno.
REG_BINARY	Datos binarios.
REG_DWORD	Palabra doble de 32 bits.
REG_DWORD_LITTLE_ENDIAN	Palabra doble de 32 bits con un formato little-endian.
REG_DWORD_BIG_ENDIAN	Palabra doble de 32 bits con un formato big-endian.
REG_LINK	Cadena Unicode que especifica un vínculo simbólico.
REG_MULTI_SZ	Varias cadenas Unicode.
REG_RESOURCE_LIST	Lista de recursos en el mapa de recursos.
REG_FULL_RESOURCE_DESCRIPTOR	Lista de recursos en la descripción del hardware.
REG_RESOURCE_REQUIREMENTS_LIST	Lista de requisitos de recursos.
REG_QWORD	Número de quadlet de 64 bits.
REG_QWORD_LITTLE_ENDIAN	Número de quadlet de 64 bits con un formato little-endian.

[in, out] ValueData

Puntero a los datos que contienen los datos del Registro que se van a leer. Los datos se convierten de UNICODE a una cadena ASCII terminada en NULL.

[in, out] ValueDataLength

Especifica el tamaño de los datos a los que apunta ValueData.

Valor devuelto

Devuelve STOR_STATUS_SUCCESS cuando la operación se realiza correctamente; de lo contrario, el código de error adecuado.

Requisitos

Requisito	Value
Plataforma de destino	Universal
Encabezado	storport.h (incluya Storport.h)
Library	Storport.lib
IRQL	PASSIVE_LEVEL

Consulte también

StorPortInitialize