ThreadPoolBoundHandle.AllocateNativeOverlapped Método
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.
Retorna um ponteiro não gerenciado para uma NativeOverlapped estrutura.
Sobrecargas
| Nome | Description |
|---|---|
| AllocateNativeOverlapped(PreAllocatedOverlapped) |
Retorna um ponteiro não gerenciado para uma NativeOverlapped estrutura usando o estado de retorno de chamada e buffers associados ao objeto especificado PreAllocatedOverlapped . |
| AllocateNativeOverlapped(IOCompletionCallback, Object, Object) |
Retorna um ponteiro não gerenciado para uma NativeOverlapped estrutura, especificando um delegado que é invocado quando a operação de E/S assíncrona é concluída, um objeto fornecido pelo usuário que fornece contexto e objetos gerenciados que servem como buffers. |
AllocateNativeOverlapped(PreAllocatedOverlapped)
Importante
Esta API não está em conformidade com CLS.
Retorna um ponteiro não gerenciado para uma NativeOverlapped estrutura usando o estado de retorno de chamada e buffers associados ao objeto especificado PreAllocatedOverlapped .
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 do qual criar o NativeOverlapped ponteiro.
Retornos
Um ponteiro não gerenciado para uma NativeOverlapped estrutura.
- Atributos
Exceções
preAllocated é null.
preAllocated está atualmente em uso para outra operação de E/S.
Esse método foi chamado depois que o ThreadPoolBoundHandle foi descartado.
-ou-
Esse método foi chamado depois preAllocated de ser 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)
Importante
Esta API não está em conformidade com CLS.
Retorna um ponteiro não gerenciado para uma NativeOverlapped estrutura, especificando um delegado que é invocado quando a operação de E/S assíncrona é concluída, um objeto fornecido pelo usuário que fornece contexto e objetos gerenciados que servem 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)]
[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 for concluída.
- state
- Object
Um objeto fornecido pelo usuário que distingue essa NativeOverlapped instância de outras NativeOverlapped instâncias.
- pinData
- Object
Um objeto ou matriz de objetos que representam o buffer de entrada ou saída da operação ou null. Cada objeto representa um buffer, como uma matriz de bytes.
Retornos
Um ponteiro não gerenciado para uma NativeOverlapped estrutura.
- Atributos
Exceções
callback é null.
Esse método foi chamado depois que o ThreadPoolBoundHandle objeto foi 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é ThreadPoolBoundHandle.FreeNativeOverlapped ser chamada.
Note
Os buffers especificados pinData são fixados durante a operação de E/S.
O buffer ou os buffers especificados pinData devem ser os mesmos passados para a função de sistema operacional não gerenciada que executa a E/S assíncrona.