AtaPortRegistryChannelSubkeyRead 関数 (irb.h)

AtaPortRegistryChannelSubKeyRead ルーチンは、レジストリ キーHKLM\CurrentControlSet\Services\<service name>\ControllerN\ChannelMの下の指定された値名に関連付けられているデータを読み取ります。ここで、N はコントローラーの番号、M はチャネルの番号です。

メモ ATA ポート ドライバーと ATA ミニポート ドライバー モデルは、今後変更または使用できない可能性があります。 代わりに、 Storport ドライバー と Storport ミニポート ドライバー モデルを使用することをお勧めします。

 

構文

BOOLEAN AtaPortRegistryChannelSubkeyRead(
  [in]            PVOID  ChannelExtension,
  [in]            UCHAR  ControllerNumber,
  [in]            PCHAR  ValueName,
  [in]            UCHAR  ValueType,
  [out, optional] PUCHAR Buffer,
                  PULONG BufferLength
);

パラメーター

[in] ChannelExtension

チャネル拡張機能へのポインター。

[in] ControllerNumber

コントローラー番号を格納します。

[in] ValueName

読み取るレジストリ値の名前を格納します。

[in] ValueType

レジストリ値に含まれるデータの種類を示します。 このメンバーには、次の表に示す値のいずれかを割り当てる必要があります。

値	意味
IDE_REG_DWORD	4 バイトの数値。
IDE_REG_BINARY	バイナリ データ。
IDE_REG_SZ	null で終わる。 Unicode 文字列。

[out, optional] Buffer

レジストリから読み取られたデータが書き込まれる宛先バッファーへのポインター。

BufferLength

コピーするデータのバイト数へのポインター。 操作が失敗した場合、 Length が指す場所は、レジストリから正常にコピーされたデータの長さに更新されます。

戻り値

操作が成功した場合、AtaPortRegistryChannelSubKeyRead は TRUE を返します。 それ以外の場合は、 FALSE を返します。 ミニポート ドライバーが正しいルーチンから呼び出さない場合も、ルーチンは FALSE を 返します。

注釈

Buffer によって指される バッファー は、 AtaPortRegistryAllocateBuffer を使用して割り当てる必要があります。

ミニポート ドライバーは、AtaChannelInitRoutine ルーチンまたは IdeHwControl ルーチンの間に AtaPortRegistryChannelSubKeyRead を呼び出す必要があります。または FALSE を返します。 さらに、ミニポート ドライバーは、その IdeHwControl ルーチンが呼び出され、ControlAction パラメーターに StartChannel または StopChannel のいずれかの値がある場合にのみ、その IdeHwControl ルーチンから AtaPortRegistryChannelSubKeyRead を呼び出すことができます。

要件

要件	値
対象プラットフォーム	デスクトップ
Header	irb.h (Ata.h、Irb.h を含む)

こちらもご覧ください

AtaChannelInitRoutine

AtaPortRegistryAllocateBuffer

AtaPortRegistryChannelSubKeyWrite

IdeHwControl