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 |