ThreadPoolBoundHandle.UnsafeAllocateNativeOverlapped 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.
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 biedt en beheerde objecten die als buffers fungeren.
public:
System::Threading::NativeOverlapped* UnsafeAllocateNativeOverlapped(System::Threading::IOCompletionCallback ^ callback, System::Object ^ state, System::Object ^ pinData);[System.CLSCompliant(false)]
public System.Threading.NativeOverlapped* UnsafeAllocateNativeOverlapped(System.Threading.IOCompletionCallback callback, object? state, object? pinData);[<System.CLSCompliant(false)>]
member this.UnsafeAllocateNativeOverlapped : System.Threading.IOCompletionCallback * obj * obj -> nativeptr<System.Threading.NativeOverlapped>Parameters
- callback
- IOCompletionCallback
Een IOCompletionCallback gemachtigde die de callback-methode vertegenwoordigt die wordt aangeroepen wanneer de asynchrone I/O-bewerking is voltooid.
- state
- Object
Een door de gebruiker opgegeven object dat dit NativeOverlapped onderscheidt van andere NativeOverlapped exemplaren. Kan zijn null.
- pinData
- Object
Een object of matrix met objecten die de invoer- of uitvoerbuffer voor de bewerking vertegenwoordigen. Elk object vertegenwoordigt een buffer, bijvoorbeeld een matrix van bytes. Kan zijn null.
Retouren
Een onbeheerde aanwijzer naar een NativeOverlapped structuur.
- Kenmerken
Uitzonderingen
callback is null.
Deze methode is aangeroepen nadat de verwijdering ThreadPoolBoundHandle is uitgevoerd.
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 FreeNativeOverlapped(NativeOverlapped*) deze wordt aangeroepen.
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.
ExecutionContext wordt niet naar de aanroep van de callback gestroomd.
Note
De opgegeven pinData buffers worden vastgemaakt voor de duur van de I/O-bewerking.
