StorPortRegistryWrite 関数 (storport.h)

StorPortRegistryWrite ルーチンは、ミニポート ドライバーによって呼び出され、指定されたバッファーに含まれるレジストリ データを ASCII から Unicode に変換し、ミニポート ドライバーの HBA ごとの記憶域にデータを書き込みます。

構文

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

パラメーター

[in] HwDeviceExtension

ハードウェア デバイス拡張機能へのポインター。 これは、ポート ドライバーが割り当て、ミニポート ドライバーの代わりに初期化する HBA ごとの記憶域です。 ミニポート ドライバーは通常、HBA の状態や HBA のマップされたアクセス範囲など、この拡張機能に HBA 固有の情報を格納します。 この領域は、ミニポート ドライバーが StorPortInitialize 呼び出した直後にミニポート ドライバーで使用できます。 ポート ドライバーは、デバイスを削除すると、このメモリを解放します。 ミニポート ドライバーは、このルーチンを呼び出すときに IRQL PASSIVE_LEVELで実行されている必要があります。

[in] ValueName

値の名前を指定する文字列へのポインター。

[in] Global

操作をアダプター固有にするか、すべてのアダプターに関連付けるかを示します。

[in] Type

次のいずれかのレジストリ データ型。

種類	意味
REG_SZ	Unicode の null で終わる文字列。
REG_EXPAND_SZ	環境変数参照を含む Unicode null で終わる文字列。
REG_BINARY	バイナリ データ。
REG_DWORD	32 ビットのダブル ワード。
REG_DWORD_LITTLE_ENDIAN	リトル エンディアン形式の 32 ビットダブル ワード。
REG_DWORD_BIG_ENDIAN	ビッグ エンディアン形式の 32 ビットダブル ワード。
REG_LINK	シンボリック リンクを指定する Unicode 文字列。
REG_MULTI_SZ	複数の Unicode 文字列。
REG_RESOURCE_LIST	リソース マップ内のリソース 一覧。
REG_FULL_RESOURCE_DESCRIPTOR	ハードウェアの説明のリソースの一覧。
REG_RESOURCE_REQUIREMENTS_LIST	リソース要件の一覧。
REG_QWORD	64 ビットのクワッドレット番号。
REG_QWORD_LITTLE_ENDIAN	リトル エンディアン形式の 64 ビットクワッドレット番号。

[in] Buffer

書き込むレジストリ データを格納しているバッファーへのポインター。

[in] BufferLength

Bufferが指すバッファーのサイズを指定します。

戻り値

StorPortRegistryWrite は、レジストリ データが正常に変換および書き込まれた場合 TRUE のブール値を返します。それ以外の場合、このルーチンは FALSE 返します。

必要条件

要件	価値
ターゲット プラットフォーム の	万国
ヘッダー	storport.h (Storport.h を含む)
ライブラリ	Storport.lib
IRQL	PASSIVE_LEVEL
DDI コンプライアンス規則 を する	StorPortIrql(storport) を する

関連項目

StorPortInitialize の