Overlapped.Pack メソッド

定義

名前空間:

System.Threading

アセンブリ:

System.Threading.Overlapped.dll

現在のインスタンスを NativeOverlapped 構造体にパックします。

オーバーロード

Pack(IOCompletionCallback)	古い. 非同期 I/O 操作が完了したときに呼び出すデリゲートを指定して、現在のインスタンスを NativeOverlapped 構造体にパックします。
Pack(IOCompletionCallback, Object)	非同期 I/O 操作が完了したときに呼び出すデリゲートと、バッファーとして機能するマネージド オブジェクトを指定して、現在のインスタンスを NativeOverlapped 構造体にパックします。

Pack(IOCompletionCallback)

ソース:

Overlapped.cs

注意事項

This overload is not safe and has been deprecated. Use Pack(IOCompletionCallback?, object?) instead.

重要

この API は CLS 準拠ではありません。

非同期 I/O 操作が完了したときに呼び出すデリゲートを指定して、現在のインスタンスを NativeOverlapped 構造体にパックします。

public:
 System::Threading::NativeOverlapped* Pack(System::Threading::IOCompletionCallback ^ iocb);

[System.CLSCompliant(false)]
[System.Obsolete("This overload is not safe and has been deprecated. Use Pack(IOCompletionCallback?, object?) instead.")]
public System.Threading.NativeOverlapped* Pack (System.Threading.IOCompletionCallback? iocb);

[<System.CLSCompliant(false)>]
[<System.Obsolete("This overload is not safe and has been deprecated. Use Pack(IOCompletionCallback?, object?) instead.")>]
member this.Pack : System.Threading.IOCompletionCallback -> nativeptr<System.Threading.NativeOverlapped>

パラメーター

iocb

IOCompletionCallback

非同期 I/O 操作が完了したときに呼び出すコールバック メソッドを表す IOCompletionCallback デリゲート。

戻り値

NativeOverlapped*

NativeOverlapped 構造体へのアンマネージ ポインター。

属性

CLSCompliantAttribute ObsoleteAttribute

例外

InvalidOperationException

現在の Overlapped は既にパックされています。

注釈

このメソッドによって返されるアンマネージド ポインターは、重複した I/O 操作でオペレーティング システムに渡すことができます。 構造体は NativeOverlapped 、 が呼び出されるまで Unpack 物理メモリで固定されます。

重要

呼び出し元は、バッファーのピン留めします。 ただし、アプリケーション ドメインがアンロードされた場合は、固定されたバッファーへのハンドルが破棄されて、バッファーが解放され、解放されたアドレスへ書き込むための I/O 操作が残ります。 このため、ランタイムがバッファーをピン留めする Pack(IOCompletionCallback, Object)メソッド オーバーロードを使用することをお勧めします。

Pack(IOCompletionCallback, Object)

ソース:

Overlapped.cs

重要

この API は CLS 準拠ではありません。

非同期 I/O 操作が完了したときに呼び出すデリゲートと、バッファーとして機能するマネージド オブジェクトを指定して、現在のインスタンスを NativeOverlapped 構造体にパックします。

public:
 System::Threading::NativeOverlapped* Pack(System::Threading::IOCompletionCallback ^ iocb, System::Object ^ userData);

[System.CLSCompliant(false)]
public System.Threading.NativeOverlapped* Pack (System.Threading.IOCompletionCallback? iocb, object? userData);

[<System.CLSCompliant(false)>]
member this.Pack : System.Threading.IOCompletionCallback * obj -> nativeptr<System.Threading.NativeOverlapped>

パラメーター

iocb

IOCompletionCallback

非同期 I/O 操作が完了したときに呼び出すコールバック メソッドを表す IOCompletionCallback デリゲート。

userData

Object

操作の入力バッファーまたは出力バッファーを表す、オブジェクトまたはオブジェクトの配列。 各オブジェクトが、バイトの配列などのバッファーを表します。

戻り値

NativeOverlapped*

NativeOverlapped 構造体へのアンマネージ ポインター。

属性

CLSCompliantAttribute

例外

InvalidOperationException

現在の Overlapped は既にパックされています。

注釈

このメソッドによって返されるアンマネージド ポインターは、重複した I/O 操作でオペレーティング システムに渡すことができます。 構造体は NativeOverlapped 、 が呼び出されるまで Unpack 物理メモリで固定されます。

で userData 指定するバッファーは、非同期 I/O を実行するアンマネージド オペレーティング システム関数に渡されるものと同じである必要があります。

注意

ランタイムは、I/O 操作の間に で userData 指定されたバッファーをピン留めします。 アプリケーション ドメインがアンロードされた場合、ランタイムは I/O 操作が完了するまでメモリを固定します。