Partilhar via


ThreadPoolBoundHandle.AllocateNativeOverlapped Método

Definição

Retorna um ponteiro não gerenciado para uma estrutura NativeOverlapped.

Sobrecargas

AllocateNativeOverlapped(PreAllocatedOverlapped)

Retorna um ponteiro não gerenciado para uma estrutura NativeOverlapped usando o estado de retorno de chamada e os buffers associados ao objeto PreAllocatedOverlapped especificado.

AllocateNativeOverlapped(IOCompletionCallback, Object, Object)

Retornará um ponteiro não gerenciado para uma estrutura NativeOverlapped, especificando um delegado invocado quando a 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.

AllocateNativeOverlapped(PreAllocatedOverlapped)

Origem:
ThreadPoolBoundHandle.cs
Origem:
ThreadPoolBoundHandle.Unix.cs
Origem:
ThreadPoolBoundHandle.Unix.cs

Importante

Esta API não está em conformidade com CLS.

Retorna um ponteiro não gerenciado para uma estrutura NativeOverlapped usando o estado de retorno de chamada e os buffers associados ao objeto PreAllocatedOverlapped especificado.

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>

Parâmetros

preAllocated
PreAllocatedOverlapped

Um objeto com base no qual o ponteiro NativeOverlapped será criado.

Retornos

Um ponteiro não gerenciado para uma estrutura NativeOverlapped.

Atributos

Exceções

preAllocated é null.

preAllocated está em uso no momento para outra operação de E/S.

Esse método foi chamado após o ThreadPoolBoundHandle ter sido descartado.

- ou -

Esse método foi chamado após o preAllocated ter sido descartado.

Comentários

O ponteiro não gerenciado retornado por esse método pode ser passado para o sistema operacional em operações de E/S sobrepostas. A NativeOverlapped estrutura é fixada na memória física até que o FreeNativeOverlapped método seja chamado.

Confira também

Aplica-se a

AllocateNativeOverlapped(IOCompletionCallback, Object, Object)

Origem:
ThreadPoolBoundHandle.cs
Origem:
ThreadPoolBoundHandle.Unix.cs
Origem:
ThreadPoolBoundHandle.Unix.cs

Importante

Esta API não está em conformidade com CLS.

Retornará um ponteiro não gerenciado para uma estrutura NativeOverlapped, especificando um delegado invocado quando a 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:
 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>

Parâmetros

callback
IOCompletionCallback

Um delegado que representa o método de retorno de chamada a ser invocado quando a operação de E/S assíncrona é concluída.

state
Object

Um objeto fornecido pelo usuário que distingue essa instância NativeOverlapped de outras instâncias NativeOverlapped.

pinData
Object

Um objeto ou uma matriz de objetos que representam o buffer de entrada ou de saída para a operação ou null. Cada objeto representa um buffer, como uma matriz de bytes.

Retornos

Um ponteiro não gerenciado para uma estrutura NativeOverlapped.

Atributos

Exceções

callback é null.

Esse método foi chamado após o objeto ThreadPoolBoundHandle ter sido descartado.

Comentários

O ponteiro não gerenciado retornado por esse método pode ser passado para o sistema operacional em operações de E/S sobrepostas. A NativeOverlapped estrutura é fixa na memória física até ThreadPoolBoundHandle.FreeNativeOverlapped ser chamada.

Observação

Os buffers especificados em pinData são fixados durante a operação de E/S.

O buffer ou os buffers especificados em pinData devem ser os mesmos passados para a função de sistema operacional não gerenciada que executa a E/S assíncrona.

Aplica-se a