AtaPortRegistryControllerKeyWrite 関数 (irb.h)
AtaPortRegistryControllerKeyWrite ルーチンは、レジストリ キーHKLM\CurrentControlSet\Services\<service name>\ControllerNの下の指定された値名 (N はコントローラーの番号) にデータを書き込みます。
構文
BOOLEAN AtaPortRegistryControllerKeyWrite(
[in] PVOID ChannelExtension,
[in] UCHAR ControllerNumber,
[in] PCHAR ValueName,
[in] UCHAR ValueType,
[in] PUCHAR Buffer,
PULONG BufferLength
);
パラメーター
[in] ChannelExtension
チャネル拡張機能へのポインター。
[in] ControllerNumber
コントローラー番号を格納します。
[in] ValueName
書き込むレジストリ値の名前を格納します。
[in] ValueType
レジストリ値に含まれるデータの種類を示します。 このメンバーには、次の表に示す値のいずれかを割り当てる必要があります。
| 値 | 意味 |
|---|---|
| IDE_REG_DWORD | 4 バイトの数値。 |
| IDE_REG_BINARY | バイナリ データ。 |
| IDE_REG_SZ | null で終わる Unicode 文字列。 |
[in] Buffer
レジストリ値に書き込むデータを含むソース バッファーへのポインター。
BufferLength
コピーするデータのバイト数へのポインター。 操作が失敗した場合、 Length が指す場所によって、レジストリに正常にコピーされたデータの長さが更新されます。
戻り値
操作が成功した場合、AtaPortRegistryControllerKeyWrite は TRUE を返します。 それ以外の場合は、 FALSE を返します。 ミニポート ドライバーが正しいルーチンから呼び出さない場合も、ルーチンは FALSE を 返します。
注釈
バッファーは、 AtaPortRegistryAllocateBuffer を使用して割り当てる必要があります。
ミニポート ドライバーは、AtaChannelInitRoutine ルーチンまたは IdeHwControl ルーチン中に AtaPortRegistryControllerKeyWrite を呼び出す必要があります。ミニポート ドライバーは、他のルーチンから AtaPortRegistryControllerKeyWrite を呼び出すことができないか、FALSE を返します。 さらに、ミニポート ドライバーは、その IdeHwControl ルーチンが呼び出され、ControlAction パラメーターに StartChannel または StopChannel の値がある場合にのみ、その IdeHwControl ルーチンから AtaPortRegistryControllerKeyWrite を呼び出すことができます。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | irb.h (Ata.h、Irb.h を含む) |