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
次のいずれかのレジストリ データ型。
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 ビットの quadlet 番号。 |
REG_QWORD_LITTLE_ENDIAN | リトル エンディアン形式の 64 ビット quadlet 番号。 |
[in] Buffer
書き込まれるレジストリ データを含むバッファーへのポインター。
[in] BufferLength
Buffer が指すバッファーのサイズを指定 します。
戻り値
レジストリ データが正常に変換および書き込まれた場合、StorPortRegistryWrite はブール値 TRUE を返します。それ以外の場合、このルーチンは FALSE を返します。
要件
要件 | 値 |
---|---|
対象プラットフォーム | ユニバーサル |
Header | storport.h (Storport.h を含む) |
Library | Storport.lib |
IRQL | PASSIVE_LEVEL |
DDI コンプライアンス規則 | StorPortIrql(storport) |