ThreadPoolBoundHandle.AllocateNativeOverlapped メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
NativeOverlapped構造体へのアンマネージ ポインターを返します。
オーバーロード
| 名前 | 説明 |
|---|---|
| AllocateNativeOverlapped(PreAllocatedOverlapped) |
指定したNativeOverlapped オブジェクトに関連付けられたコールバック状態とバッファーを使用して、PreAllocatedOverlapped構造体へのアンマネージ ポインターを返します。 |
| AllocateNativeOverlapped(IOCompletionCallback, Object, Object) |
非同期 I/O 操作が完了したときに呼び出されるデリゲート、コンテキストを提供するユーザー指定のオブジェクト、およびバッファーとして機能するマネージド オブジェクトを指定して、 NativeOverlapped 構造体へのアンマネージ ポインターを返します。 |
AllocateNativeOverlapped(PreAllocatedOverlapped)
重要
この API は CLS 準拠ではありません。
指定したNativeOverlapped オブジェクトに関連付けられたコールバック状態とバッファーを使用して、PreAllocatedOverlapped構造体へのアンマネージ ポインターを返します。
public:
System::Threading::NativeOverlapped* AllocateNativeOverlapped(System::Threading::PreAllocatedOverlapped ^ preAllocated);
[System.CLSCompliant(false)]
public System.Threading.NativeOverlapped* AllocateNativeOverlapped(System.Threading.PreAllocatedOverlapped preAllocated);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public System.Threading.NativeOverlapped* AllocateNativeOverlapped(System.Threading.PreAllocatedOverlapped preAllocated);
[<System.CLSCompliant(false)>]
member this.AllocateNativeOverlapped : System.Threading.PreAllocatedOverlapped -> nativeptr<System.Threading.NativeOverlapped>
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
member this.AllocateNativeOverlapped : System.Threading.PreAllocatedOverlapped -> nativeptr<System.Threading.NativeOverlapped>
パラメーター
- preAllocated
- PreAllocatedOverlapped
NativeOverlapped ポインターの作成元のオブジェクト。
返品
NativeOverlapped構造体へのアンマネージ ポインター。
- 属性
例外
preAllocated は nullです。
preAllocated は現在、別の I/O 操作で使用されています。
注釈
このメソッドによって返されるアンマネージ ポインターは、重複した I/O 操作でオペレーティング システムに渡すことができます。 NativeOverlapped構造体は、FreeNativeOverlapped メソッドが呼び出されるまで物理メモリ内で固定されます。
こちらもご覧ください
適用対象
AllocateNativeOverlapped(IOCompletionCallback, Object, Object)
重要
この API は CLS 準拠ではありません。
非同期 I/O 操作が完了したときに呼び出されるデリゲート、コンテキストを提供するユーザー指定のオブジェクト、およびバッファーとして機能するマネージド オブジェクトを指定して、 NativeOverlapped 構造体へのアンマネージ ポインターを返します。
public:
System::Threading::NativeOverlapped* AllocateNativeOverlapped(System::Threading::IOCompletionCallback ^ callback, System::Object ^ state, System::Object ^ pinData);
[System.CLSCompliant(false)]
public System.Threading.NativeOverlapped* AllocateNativeOverlapped(System.Threading.IOCompletionCallback callback, object state, object pinData);
[System.CLSCompliant(false)]
public System.Threading.NativeOverlapped* AllocateNativeOverlapped(System.Threading.IOCompletionCallback callback, object? state, object? pinData);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public System.Threading.NativeOverlapped* AllocateNativeOverlapped(System.Threading.IOCompletionCallback callback, object state, object pinData);
[<System.CLSCompliant(false)>]
member this.AllocateNativeOverlapped : System.Threading.IOCompletionCallback * obj * obj -> nativeptr<System.Threading.NativeOverlapped>
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
member this.AllocateNativeOverlapped : System.Threading.IOCompletionCallback * obj * obj -> nativeptr<System.Threading.NativeOverlapped>
パラメーター
- callback
- IOCompletionCallback
非同期 I/O 操作が完了したときに呼び出すコールバック メソッドを表すデリゲート。
- state
- Object
この NativeOverlapped インスタンスを他の NativeOverlapped インスタンスと区別するユーザー指定のオブジェクト。
- pinData
- Object
操作の入力バッファーまたは出力バッファーを表すオブジェクトのオブジェクトまたは配列、または null。 各オブジェクトは、バイト配列などのバッファーを表します。
返品
NativeOverlapped構造体へのアンマネージ ポインター。
- 属性
例外
callback は nullです。
このメソッドは、 ThreadPoolBoundHandle オブジェクトが破棄された後に呼び出されました。
注釈
このメソッドによって返されるアンマネージ ポインターは、重複した I/O 操作でオペレーティング システムに渡すことができます。 NativeOverlapped構造体は、ThreadPoolBoundHandle.FreeNativeOverlappedが呼び出されるまで物理メモリ内で固定されます。
Note
pinDataで指定されたバッファーは、I/O 操作の間ピン留めされます。
pinDataで指定するバッファーは、非同期 I/O を実行するアンマネージド オペレーティング システム関数に渡されるものと同じである必要があります。