ThreadPoolBoundHandle.AllocateNativeOverlapped Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Devuelve un puntero no administrado a una NativeOverlapped estructura.
Sobrecargas
| Nombre | Description |
|---|---|
| AllocateNativeOverlapped(PreAllocatedOverlapped) |
Devuelve un puntero no administrado a una NativeOverlapped estructura mediante el estado de devolución de llamada y los búferes asociados al objeto especificado PreAllocatedOverlapped . |
| AllocateNativeOverlapped(IOCompletionCallback, Object, Object) |
Devuelve un puntero no administrado a una NativeOverlapped estructura, especificando un delegado que se invoca cuando se completa la operación asincrónica de E/S, un objeto proporcionado por el usuario que proporciona contexto y objetos administrados que actúan como búferes. |
AllocateNativeOverlapped(PreAllocatedOverlapped)
Importante
Esta API no es conforme a CLS.
Devuelve un puntero no administrado a una NativeOverlapped estructura mediante el estado de devolución de llamada y los búferes asociados al 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
Objeto desde el que se va a crear el NativeOverlapped puntero.
Devoluciones
Puntero no administrado a una NativeOverlapped estructura.
- Atributos
Excepciones
preAllocated es null.
preAllocated actualmente está en uso para otra operación de E/S.
Se llamó a este método después de ThreadPoolBoundHandle desechar .
O bien
Se llamó a este método después preAllocated de eliminarse.
Comentarios
El puntero no administrado devuelto por este método se puede pasar al sistema operativo en operaciones de E/S superpuestas. La NativeOverlapped estructura se fija en memoria física hasta que se llama al FreeNativeOverlapped método .
Consulte también
Se aplica a
AllocateNativeOverlapped(IOCompletionCallback, Object, Object)
Importante
Esta API no es conforme a CLS.
Devuelve un puntero no administrado a una NativeOverlapped estructura, especificando un delegado que se invoca cuando se completa la operación asincrónica de E/S, un objeto proporcionado por el usuario que proporciona contexto y objetos administrados que actúan como búferes.
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
Delegado que representa el método de devolución de llamada que se va a invocar cuando se completa la operación asincrónica de E/S.
- state
- Object
Objeto proporcionado por el usuario que distingue esta NativeOverlapped instancia de otras NativeOverlapped instancias.
- pinData
- Object
Objeto o matriz de objetos que representan el búfer de entrada o salida para la operación, o null. Cada objeto representa un búfer, como una matriz de bytes.
Devoluciones
Puntero no administrado a una NativeOverlapped estructura.
- Atributos
Excepciones
callback es null.
Se llamó a este método después de eliminar el ThreadPoolBoundHandle objeto.
Comentarios
El puntero no administrado devuelto por este método se puede pasar al sistema operativo en operaciones de E/S superpuestas. La NativeOverlapped estructura se fija en memoria física hasta ThreadPoolBoundHandle.FreeNativeOverlapped que se llama a .
Note
Los búferes especificados en pinData se anclan durante la operación de E/S.
El búfer o los búferes especificados en pinData deben ser los mismos que los pasados a la función del sistema operativo no administrado que realiza la E/S asincrónica.