ThreadPoolBoundHandle.AllocateNativeOverlapped Méthode

Définition

Espace de noms:

System.Threading

Assemblys:

mscorlib.dll, System.Threading.Overlapped.dll

Assembly:

System.Threading.Overlapped.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Retourne un pointeur non managé vers une structure NativeOverlapped.

Surcharges

AllocateNativeOverlapped(PreAllocatedOverlapped)	Retourne un pointeur non managé vers une structure NativeOverlapped à l’aide de l’état de rappel et des mémoires tampons associées à l’objet PreAllocatedOverlapped spécifié.
AllocateNativeOverlapped(IOCompletionCallback, Object, Object)	Retourne un pointeur non managé vers une structure NativeOverlapped, spécifiant un délégué appelé quand l’opération d’E/S asynchrone est terminée, un objet fourni par l’utilisateur qui fournit un contexte, et des objets gérés qui font office de mémoires tampons.

AllocateNativeOverlapped(PreAllocatedOverlapped)

Important

Cette API n’est pas conforme CLS.

Retourne un pointeur non managé vers une structure NativeOverlapped à l’aide de l’état de rappel et des mémoires tampons associées à l’objet PreAllocatedOverlapped spécifié.

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>

Paramètres

preAllocated

PreAllocatedOverlapped

Objet à partir duquel créer le pointeur NativeOverlapped.

Retours

NativeOverlapped*

Pointeur non managé vers une structure NativeOverlapped.

Attributs

CLSCompliantAttribute SecurityCriticalAttribute

Exceptions

ArgumentNullException

preAllocated a la valeur null.

ArgumentException

preAllocated est en cours d’utilisation pour une autre opération d’E/S.

ObjectDisposedException

Cette méthode a été appelée après la suppression de ThreadPoolBoundHandle.

• ou - Cette méthode a été appelée après la suppression de preAllocated.

Remarques

Le pointeur non managé retourné par cette méthode peut être passé au système d’exploitation en opérations d’E/S qui se chevauchent. La NativeOverlapped structure est fixe en mémoire physique jusqu’à ce que la FreeNativeOverlapped méthode soit appelée.

Voir aussi

• PreAllocatedOverlapped

AllocateNativeOverlapped(IOCompletionCallback, Object, Object)

Important

Cette API n’est pas conforme CLS.

Retourne un pointeur non managé vers une structure NativeOverlapped, spécifiant un délégué appelé quand l’opération d’E/S asynchrone est terminée, un objet fourni par l’utilisateur qui fournit un contexte, et des objets gérés qui font office de mémoires tampons.

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>

Paramètres

callback

IOCompletionCallback

Délégué qui représente la méthode de rappel à appeler quand l’opération d’E/S asynchrone se termine.

state

Object

Objet fourni par l’utilisateur qui distingue cette instance de NativeOverlapped des autres instances de NativeOverlapped.

pinData

Object

Objet ou tableau d’objets qui représente la mémoire tampon d’entrée ou de sortie pour l’opération ou null. Chaque objet représente une mémoire tampon, comme un tableau d’octets.

Retours

NativeOverlapped*

Pointeur non managé vers une structure NativeOverlapped.

Attributs

CLSCompliantAttribute SecurityCriticalAttribute

Exceptions

ArgumentNullException

callback a la valeur null.

ObjectDisposedException

Cette méthode a été appelée après la suppression de l’objet ThreadPoolBoundHandle.

Remarques

Le pointeur non managé retourné par cette méthode peut être passé au système d’exploitation en opérations d’E/S qui se chevauchent. La NativeOverlapped structure est fixe en mémoire physique jusqu’à ce qu’elle ThreadPoolBoundHandle.FreeNativeOverlapped soit appelée.

Notes

Les mémoires tampons spécifiées pinData sont épinglées pendant la durée de l’opération d’E/S.

La mémoire tampon ou les mémoires tampons spécifiées doivent pinData être identiques à celles passées à la fonction de système d’exploitation non managée qui effectue les E/S asynchrones.