ThreadPoolBoundHandle.AllocateNativeOverlapped Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Retourneert een onbeheerde aanwijzer naar een NativeOverlapped structuur.
Overloads
| Name | Description |
|---|---|
| AllocateNativeOverlapped(PreAllocatedOverlapped) |
Retourneert een onbeheerde aanwijzer naar een NativeOverlapped structuur met behulp van de callbackstatus en buffers die zijn gekoppeld aan het opgegeven PreAllocatedOverlapped object. |
| AllocateNativeOverlapped(IOCompletionCallback, Object, Object) |
Retourneert een onbeheerde aanwijzer naar een NativeOverlapped structuur, waarbij een gemachtigde wordt opgegeven die wordt aangeroepen wanneer de asynchrone I/O-bewerking is voltooid, een door de gebruiker verstrekt object dat context levert en beheerde objecten die als buffers fungeren. |
AllocateNativeOverlapped(PreAllocatedOverlapped)
Belangrijk
Deze API is niet CLS-conform.
Retourneert een onbeheerde aanwijzer naar een NativeOverlapped structuur met behulp van de callbackstatus en buffers die zijn gekoppeld aan het opgegeven PreAllocatedOverlapped object.
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>Parameters
- preAllocated
- PreAllocatedOverlapped
Een object waaruit de NativeOverlapped aanwijzer moet worden gemaakt.
Retouren
Een onbeheerde aanwijzer naar een NativeOverlapped structuur.
- Kenmerken
Uitzonderingen
preAllocated is null.
preAllocated is momenteel in gebruik voor een andere I/O-bewerking.
Deze methode is aangeroepen nadat de verwijdering ThreadPoolBoundHandle is uitgevoerd.
– of –
Deze methode is aangeroepen nadat preAllocated deze is verwijderd.
Opmerkingen
De niet-beheerde aanwijzer die door deze methode wordt geretourneerd, kan worden doorgegeven aan het besturingssysteem in overlappende I/O-bewerkingen. De NativeOverlapped structuur wordt in het fysieke geheugen opgelost totdat de FreeNativeOverlapped methode wordt aangeroepen.
Zie ook
Van toepassing op
AllocateNativeOverlapped(IOCompletionCallback, Object, Object)
Belangrijk
Deze API is niet CLS-conform.
Retourneert een onbeheerde aanwijzer naar een NativeOverlapped structuur, waarbij een gemachtigde wordt opgegeven die wordt aangeroepen wanneer de asynchrone I/O-bewerking is voltooid, een door de gebruiker verstrekt object dat context levert en beheerde objecten die als buffers fungeren.
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>Parameters
- callback
- IOCompletionCallback
Een gemachtigde die de callback-methode vertegenwoordigt die moet worden aangeroepen wanneer de asynchrone I/O-bewerking is voltooid.
- state
- Object
Een door de gebruiker verstrekt object dat dit NativeOverlapped exemplaar onderscheidt van andere NativeOverlapped exemplaren.
- pinData
- Object
Een object of matrix met objecten die de invoer- of uitvoerbuffer voor de bewerking vertegenwoordigen, of null. Elk object vertegenwoordigt een buffer, zoals een matrix van bytes.
Retouren
Een onbeheerde aanwijzer naar een NativeOverlapped structuur.
- Kenmerken
Uitzonderingen
callback is null.
Deze methode is aangeroepen nadat het ThreadPoolBoundHandle object is verwijderd.
Opmerkingen
De niet-beheerde aanwijzer die door deze methode wordt geretourneerd, kan worden doorgegeven aan het besturingssysteem in overlappende I/O-bewerkingen. De NativeOverlapped structuur is opgelost in het fysieke geheugen totdat ThreadPoolBoundHandle.FreeNativeOverlapped deze wordt aangeroepen.
Note
De opgegeven pinData buffers worden vastgemaakt voor de duur van de I/O-bewerking.
De opgegeven pinData buffers of buffers moeten hetzelfde zijn als de buffers die worden doorgegeven aan de onbeheerde besturingssysteemfunctie die de asynchrone I/O uitvoert.