WriteLongPtrToUserRelease 関数 (usermode_accessors.h)

The WriteLongPtrToUserRelease function safely writes a LONG_PTR value to user-mode memory with release semantics.

Syntax

VOID WriteLongPtrToUserRelease(
  volatile LONG_PTR *Destination,
  LONG_PTR          Value
);

Parameters

Destination

[out]LONG_PTR値が書き込まれるユーザー モードのメモリ位置へのポインター。

Value

[in]宛先メモリの場所に書き込むLONG_PTR値。

Return value

None

Remarks

この関数は、ユーザー モード メモリにLONG_PTR値を書き込む安全な方法を提供します。 指定されたアドレスが、書き込み前にユーザー モード のアドレスであることを確認します。 The release semantics ensure that preceding memory operations can't be reordered after this write operation.

この関数では、配置は適用されません。

宛先アドレスがユーザー モード アドレスではない場合やアクセスできない場合など、メモリ アクセスが失敗した場合は、構造化例外が発生します。

この関数はコンパイラによって最適化されることも、関数が呼び出される前または関数が戻った後に (ソース コードが明示的にこれらのアクセスを実行しない限り) このメモリ位置への追加のアクセスを作成することもありません。 The memory access is performed with memory_order_release semantics.

この関数は、最新バージョンだけでなく、すべてのバージョンの Windows で動作します。 You need to consume the latest WDK to get the function declaration from the usermode_accessors.h header. You also need the library (umaccess.lib) from the latest WDK. ただし、結果として得られるドライバーは、古いバージョンの Windows では正常に動作します。

Requirements

See also

WriteLongPtrToUser

ReadLongPtrFromUserAcquire