StorPortRegistryReadAdapterKey 関数 (storport.h)

StorPortRegistryReadAdapterKey ルーチンは、HKLM/CurrentControlSet/Enum/Instance path/DeviceParameters/..のレジストリにあるハードウェアまたはデバイス レジストリ アダプター キーを読み取るためにミニポート ドライバーによって呼び出されます。これらのキーは、INF DDInstall.HW セクションで読み取られます。

構文

ULONG StorPortRegistryReadAdapterKey(
  [in]           PVOID  HwDeviceExtension,
  [in, optional] PUCHAR SubKeyName,
  [in]           PUCHAR ValueName,
  [in]           ULONG  ValueType,
  [in, out]      PVOID  *ValueData,
  [in, out]      PULONG ValueDataLength
);

パラメーター

[in] HwDeviceExtension

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

[in, optional] SubKeyName

ミニポート サブキー。

[in] ValueName

キーの下にある Value の名前。

[in] ValueType

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

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, out] ValueData

読み取るレジストリ データを含むデータへのポインター。 データは UNICODE から NULL で終わる ASCII 文字列に変換されます。

[in, out] ValueDataLength

ValueData が指すデータのサイズを指定します。

戻り値

操作が成功したときにSTOR_STATUS_SUCCESSを返します。それ以外の場合は、適切なエラー コードを返します。

要件

要件	値
対象プラットフォーム	ユニバーサル
Header	storport.h (Storport.h を含む)
Library	Storport.lib
IRQL	PASSIVE_LEVEL

こちらもご覧ください

StorPortInitialize