PreAllocatedOverlapped(IOCompletionCallback, Object, Object) 생성자

정의

중요

이 API는 CLS 규격이 아닙니다.

PreAllocatedOverlapped 클래스의 새 인스턴스를 초기화하고 각 비동기 I/O 작업이 완료될 때 호출할 대리자, 컨텍스트를 제공하는 사용자 제공 개체, 버퍼로 사용되는 관리되는 개체를 지정합니다.Initializes a new instance of the PreAllocatedOverlapped class and specifies a delegate to invoke when each asynchronous I/O operation is complete, a user-provided object that provides context, and managed objects that serve as buffers.

public:
 PreAllocatedOverlapped(System::Threading::IOCompletionCallback ^ callback, System::Object ^ state, System::Object ^ pinData);
[System.CLSCompliant(false)]
public PreAllocatedOverlapped (System.Threading.IOCompletionCallback callback, object state, object pinData);
new System.Threading.PreAllocatedOverlapped : System.Threading.IOCompletionCallback * obj * obj -> System.Threading.PreAllocatedOverlapped
Public Sub New (callback As IOCompletionCallback, state As Object, pinData As Object)

매개 변수

callback
IOCompletionCallback

각 비동기 I/O 작업이 완료될 때 호출할 콜백 메서드를 나타내는 대리자입니다.A delegate that represents the callback method to invoke when each asynchronous I/O operation completes.

state
Object

이 개체에서 생성된 NativeOverlapped 인스턴스와 다른 NativeOverlapped 인스턴스를 구별하는 사용자 제공 개체입니다.A user-supplied object that distinguishes the NativeOverlapped instance produced from this object from other NativeOverlapped instances. 이 값은 null일 수 있습니다.Its value can be null.

pinData
Object

작업에 대한 입력 또는 출력 버퍼를 나타내는 개체의 배열 또는 개체입니다.An object or array of objects that represent the input or output buffer for the operations. 각 개체는 바이트 배열과 같은 버퍼를 나타냅니다.Each object represents a buffer, such as an array of bytes. 이 값은 null일 수 있습니다.Its value can be null.

특성

예외

callbacknull인 경우callback is null.

이 메서드는 ThreadPoolBoundHandle이 삭제된 후 호출되었습니다.This method was called after the ThreadPoolBoundHandle was disposed.

설명

PreAllocatedOverlapped 인스턴스를 AllocateNativeOverlapped 메서드에 전달 하 여 겹쳐진 i/o 작업으로 운영 체제에 전달할 수 있는 NativeOverlapped 인스턴스를 생성할 수 있습니다.The new PreAllocatedOverlapped instance can be passed to the AllocateNativeOverlapped method to produce a NativeOverlapped instance that can be passed to the operating system in overlapped I/O operations. 단일 PreAllocatedOverlapped 인스턴스는 한 번에 하나의 네이티브 i/o 작업에만 사용할 수 있습니다.A single PreAllocatedOverlapped instance can only be used for a single native I/O operation at a time. 그러나 PreAllocatedOverlapped 인스턴스에 저장 된 상태는 후속 네이티브 작업에 다시 사용할 수 있습니다.However, the state stored in the PreAllocatedOverlapped instance can be reused for subsequent native operations.

참고

pinData에 지정 된 버퍼는 Dispose 메서드가 호출 될 때까지 고정 됩니다.The buffers specified in pinData are pinned until the Dispose method is called.

적용 대상