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)

Consulte también

StorPortInitialize