PreAllocatedOverlapped(IOCompletionCallback, Object, Object) Construtor
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Importante
Esta API não está em conformidade com CLS.
Inicializa uma nova instância da classe PreAllocatedOverlapped e especifica um delegado a ser invocado quando cada operação de E/S assíncrona for concluída, um objeto fornecido pelo usuário que oferece contexto e objetos gerenciados que funcionam como 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);
[System.CLSCompliant(false)]
public PreAllocatedOverlapped (System.Threading.IOCompletionCallback callback, object? state, object? pinData);
[<System.CLSCompliant(false)>]
new System.Threading.PreAllocatedOverlapped : System.Threading.IOCompletionCallback * obj * obj -> System.Threading.PreAllocatedOverlapped
Public Sub New (callback As IOCompletionCallback, state As Object, pinData As Object)
Parâmetros
- callback
- IOCompletionCallback
Um delegado que representa o método de retorno de chamada a ser invocado quando cada operação de E/S assíncrona é concluída.
- state
- Object
Um objeto fornecido pelo usuário que distingue a instância NativeOverlapped produzida com base nesse objeto de outras instâncias NativeOverlapped. Seu valor pode ser null
.
- pinData
- Object
Um objeto ou uma matriz de objetos que representam o buffer de entrada ou de saída para as operações. Cada objeto representa um buffer, como uma matriz de bytes. Seu valor pode ser null
.
- Atributos
Exceções
callback
é null
.
Esse método foi chamado após o ThreadPoolBoundHandle ter sido descartado.
Comentários
A nova PreAllocatedOverlapped instância pode ser passada para o AllocateNativeOverlapped método para produzir uma NativeOverlapped instância que pode ser passada para o sistema operacional em operações de E/S sobrepostas. Uma única PreAllocatedOverlapped instância só pode ser usada para uma única operação de E/S nativa por vez. No entanto, o estado armazenado na PreAllocatedOverlapped instância pode ser reutilizado para operações nativas subsequentes.
Observação
Os buffers especificados pinData
são fixados até que o Dispose método seja chamado.