Función StorPortRegistryWrite (storport.h)
El controlador de miniportador llama a la rutina StorPortRegistryWrite para convertir los datos del Registro contenidos en un búfer especificado de ASCII a Unicode y, a continuación, escribir los datos en el área de almacenamiento por HBA del controlador de miniport.
Sintaxis
STORPORT_API BOOLEAN StorPortRegistryWrite(
[in] PVOID HwDeviceExtension,
[in] PUCHAR ValueName,
[in] ULONG Global,
[in] ULONG Type,
[in] PUCHAR Buffer,
[in] ULONG BufferLength
);
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] ValueName
Puntero a una cadena que especifica el nombre del valor.
[in] Global
Indica si la operación debe ser específica del adaptador o relacionarse con todos los adaptadores.
[in] Type
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] Buffer
Puntero a un búfer que contiene los datos del Registro que se van a escribir.
[in] BufferLength
Especifica el tamaño del búfer al que apunta el búfer.
Valor devuelto
StorPortRegistryWrite devuelve un valor booleano de TRUE si los datos del Registro se convirtieron y escribieron correctamente; de lo contrario, esta rutina devuelve FALSE.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Encabezado | storport.h (incluya Storport.h) |
| Library | Storport.lib |
| IRQL | PASSIVE_LEVEL |
| Reglas de cumplimiento de DDI | StorPortIrql(storport) |