ThreadPoolBoundHandle.UnsafeAllocateNativeOverlapped 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
重要
此 API 不符合 CLS 規範。
傳回結構的 Unmanaged 指標 NativeOverlapped ,指定非同步 I/O 作業完成時叫用的委派、提供內容的使用者提供物件,以及做為緩衝區的 Managed 物件。
public:
System::Threading::NativeOverlapped* UnsafeAllocateNativeOverlapped(System::Threading::IOCompletionCallback ^ callback, System::Object ^ state, System::Object ^ pinData);
[System.CLSCompliant(false)]
public System.Threading.NativeOverlapped* UnsafeAllocateNativeOverlapped (System.Threading.IOCompletionCallback callback, object? state, object? pinData);
[<System.CLSCompliant(false)>]
member this.UnsafeAllocateNativeOverlapped : System.Threading.IOCompletionCallback * obj * obj -> nativeptr<System.Threading.NativeOverlapped>
參數
- callback
- IOCompletionCallback
IOCompletionCallback 委派,表示非同步的 I/O 作業完成時所要叫用的回呼方法。
- state
- Object
使用者提供的物件,可區分此 NativeOverlapped 物件與其他 NativeOverlapped 實例。 可以是 null
。
- pinData
- Object
物件或物件陣列,表示作業的輸入或輸出緩衝區。 每個物件代表一個緩衝區,例如位元組陣列。 可以是 null
。
傳回
NativeOverlapped 結構的 Unmanaged 指標。
- 屬性
例外狀況
callback
為 null
。
處置 ThreadPoolBoundHandle 後才呼叫這個方法。
備註
此方法傳回的 Unmanaged 指標可以傳遞至重迭 I/O 作業中的作業系統。 結構 NativeOverlapped 固定在實體記憶體中,直到 FreeNativeOverlapped(NativeOverlapped*) 呼叫為止。
中指定的 pinData
緩衝區或緩衝區必須與傳遞至執行非同步 I/O 之 Unmanaged 作業系統函式的緩衝區相同。
ExecutionContext 不會流向回呼的調用。
注意
中指定的 pinData
緩衝區會固定在 I/O 作業的持續時間內。