Marshal.GetFunctionPointerForDelegate Método

Source:

Marshal.cs

Source:

Marshal.cs

Source:

Marshal.cs

Source:

Marshal.cs

Source:

Marshal.cs

public:
 static IntPtr GetFunctionPointerForDelegate(Delegate ^ d);

[System.Obsolete("GetFunctionPointerForDelegate(Delegate) may be unavailable in future releases. Instead, use GetFunctionPointerForDelegate<T>(T). For more info, go to http://go.microsoft.com/fwlink/?LinkID=296522")]
[System.Security.SecurityCritical]
public static IntPtr GetFunctionPointerForDelegate(Delegate d);

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Marshalling code for the delegate might not be available. Use the GetFunctionPointerForDelegate<TDelegate> overload instead.")]
public static IntPtr GetFunctionPointerForDelegate(Delegate d);

public static IntPtr GetFunctionPointerForDelegate(Delegate d);

[System.Security.SecurityCritical]
public static IntPtr GetFunctionPointerForDelegate(Delegate d);

[<System.Obsolete("GetFunctionPointerForDelegate(Delegate) may be unavailable in future releases. Instead, use GetFunctionPointerForDelegate<T>(T). For more info, go to http://go.microsoft.com/fwlink/?LinkID=296522")>]
[<System.Security.SecurityCritical>]
static member GetFunctionPointerForDelegate : Delegate -> nativeint

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Marshalling code for the delegate might not be available. Use the GetFunctionPointerForDelegate<TDelegate> overload instead.")>]
static member GetFunctionPointerForDelegate : Delegate -> nativeint

static member GetFunctionPointerForDelegate : Delegate -> nativeint

[<System.Security.SecurityCritical>]
static member GetFunctionPointerForDelegate : Delegate -> nativeint

Public Shared Function GetFunctionPointerForDelegate (d As Delegate) As IntPtr

Parámetros

Devoluciones

Valor que se puede pasar al código no administrado, que, a su vez, puede usarlo para llamar al delegado administrado subyacente.

Atributos

ObsoleteAttribute SecurityCriticalAttribute RequiresDynamicCodeAttribute

Excepciones

Comentarios

El delegado se convierte en un puntero de función que se puede pasar al código no administrado mediante la convención de llamada de plataforma predeterminada. Puede establecer la convención de llamada aplicando al delegado.

Debe evitar que el recolector de elementos no utilizados recopile manualmente el delegado del código administrado. El recolector de elementos no utilizados no realiza un seguimiento de las referencias al código no administrado. Use para evitar que el delegado se recopile antes de que se complete la llamada nativa:

var callback = new MyNativeCallback(MyManagedMethod);
IntPtr fnPtr = Marshal.GetFunctionPointerForDelegate(callback);
NativeMethod(fnPtr);
GC.KeepAlive(callback); // Prevent collection — fnPtr does not root the delegate.

P/Invoke que serializa un delegado controla en nombre del usuario:

var callback = new MyNativeCallback(MyManagedMethod);
NativeMethod(callback); // P/Invoke marshals the delegate and keeps it alive for the duration of the call.

Si el código nativo almacena el puntero de función más allá de la duración de la llamada, raíz el delegado durante toda su duración, por ejemplo, almacenándolo en un campo.

Esta API no se admite en entornos que no admiten la asignación dinámica de puntos de entrada, como en Windows, en SELinux y WebAssembly.

Se recomienda usar punteros de función y en su lugar. Los punteros de función son más eficaces, más fáciles de usar correctamente y se admiten en todos los entornos.

Source:

Marshal.cs

Source:

Marshal.cs

Source:

Marshal.cs

Source:

Marshal.cs

Source:

Marshal.cs

public:
generic <typename TDelegate>
 static IntPtr GetFunctionPointerForDelegate(TDelegate d);

[System.Security.SecurityCritical]
public static IntPtr GetFunctionPointerForDelegate<TDelegate>(TDelegate d);

public static IntPtr GetFunctionPointerForDelegate<TDelegate>(TDelegate d);

[<System.Security.SecurityCritical>]
static member GetFunctionPointerForDelegate : 'Delegate -> nativeint

static member GetFunctionPointerForDelegate : 'Delegate -> nativeint

Public Shared Function GetFunctionPointerForDelegate(Of TDelegate) (d As TDelegate) As IntPtr

Parámetros de tipo

Parámetros

Devoluciones

Valor que se puede pasar al código no administrado, que, a su vez, puede usarlo para llamar al delegado administrado subyacente.

Atributos

SecurityCriticalAttribute

Excepciones

Comentarios

El delegado se convierte en un puntero de función que se puede pasar al código no administrado mediante la convención de llamada de plataforma predeterminada. Puede establecer la convención de llamada aplicando al delegado.

Debe evitar que el recolector de elementos no utilizados recopile manualmente el delegado del código administrado. El recolector de elementos no utilizados no realiza un seguimiento de las referencias al código no administrado. Use para evitar que el delegado se recopile antes de que se complete la llamada nativa:

var callback = new MyNativeCallback(MyManagedMethod);
IntPtr fnPtr = Marshal.GetFunctionPointerForDelegate(callback);
NativeMethod(fnPtr);
GC.KeepAlive(callback); // Prevent collection — fnPtr does not root the delegate.

P/Invoke que serializa un delegado controla en nombre del usuario:

var callback = new MyNativeCallback(MyManagedMethod);
NativeMethod(callback); // P/Invoke marshals the delegate and keeps it alive for the duration of the call.

Si el código nativo almacena el puntero de función más allá de la duración de la llamada, raíz el delegado durante toda su duración, por ejemplo, almacenándolo en un campo.

Esta API no se admite en entornos que no admiten la asignación dinámica de puntos de entrada, como en Windows, en SELinux y WebAssembly.

Se recomienda usar punteros de función y en su lugar. Los punteros de función son más eficaces, más fáciles de usar correctamente y se admiten en todos los entornos.