StorPortRegistryWrite routine

The StorPortRegistryWrite routine is called by the miniport driver to convert the registry data contained in a specified buffer from ASCII to Unicode and to then write the data to the miniport driver's per-HBA storage area.

Syntax


STORPORT_API BOOLEAN StorPortRegistryWrite(
  _In_  PVOID HwDeviceExtension,
  _In_  PUCHAR ValueName,
  _In_  ULONG Global,
  _In_  ULONG Type,
  _In_  PUCHAR Buffer,
  _In_  ULONG BufferLength
);

Parameters

HwDeviceExtension [in]

A pointer to the hardware device extension. This is a per HBA storage area that the port driver allocates and initializes on behalf of the miniport driver. Miniport drivers usually store HBA-specific information in this extension, such as the state of the HBA and the mapped access ranges for the HBA. This area is available to the miniport driver immediately after the miniport driver calls StorPortInitialize. The port driver frees this memory when it removes the device. The miniport driver must be running at IRQL PASSIVE_LEVEL when it calls this routine.

ValueName [in]

Pointer to a string that specifies the value name.

Global [in]

Indicates whether the operation is to be adapter specific or to relate to all adapters.

Type [in]

One of the following registry data types.

TypeMeaning

REG_SZ

Unicode null-terminated string.

REG_EXPAND_SZ

Unicode null-terminated string with environment variable references.

REG_BINARY

Binary data.

REG_DWORD

32-bit double word.

REG_DWORD_LITTLE_ENDIAN

32-bit double word with a little-endian format.

REG_DWORD_BIG_ENDIAN

32-bit double word with a big-endian format.

REG_LINK

Unicode string that specifies a symbolic link.

REG_MULTI_SZ

Multiple Unicode strings.

REG_RESOURCE_LIST

Resource list in the resource map.

REG_FULL_RESOURCE_DESCRIPTOR

Resource list in the hardware description.

REG_RESOURCE_REQUIREMENTS_LIST

Resource requirement list.

REG_QWORD

64-bit quadlet number.

REG_QWORD_LITTLE_ENDIAN

64-bit quadlet number with a little-endian format.

 

Buffer [in]

Pointer to a buffer that contains the registry data to be written.

BufferLength [in]

Specifies the size of the buffer pointed to by Buffer.

Return value

StorPortRegistryWrite returns a Boolean value of TRUE if the registry data was successfully converted and written; otherwise, this routine returns FALSE.

Requirements

Header

Storport.h (include Storport.h)

Library

Storport.lib

IRQL

PASSIVE_LEVEL

DDI compliance rules

StorPortIrql

See also

StorPortInitialize

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft