Практическое руководство. Реализация функций обратного вызова
В приведенных ниже процедуре и примере описывается, как из управляемого приложения, используя вызов неуправляемого кода, можно напечатать значение дескриптора для каждого окна на локальном компьютере. Конкретно, для печати значения дескриптора окна в процедуре и примере используется функция EnumWindows, которая просматривает список окон, и управляемая функция обратного вызова CallBack.
Реализация функции обратного вызова
Прежде чем приступить к реализации, обратите внимание на сигнатуру функции EnumWindows. Функция EnumWindows использует следующую сигнатуру:
BOOL EnumWindows(WNDENUMPROC lpEnumFunc, LPARAM lParam)Признаком необходимости обратного вызова для функции является наличие аргумента lpEnumFunc. Обычно в имени аргументов, которые получают указатель на функцию обратного вызова, присутствует префикс lp (long pointer; длинный указатель) и суффикс Func. Документацию по функциям Win32 см. в Microsoft Platform SDK.
Создайте управляемую функцию обратного вызова. В примере объявляется тип делегата CallBack, который принимает два аргумента (hwnd и lparam). Первый аргумент — это дескриптор окна, а второй определяется приложением. В этом выпуске оба аргумента должны быть целыми числами.
Функции обратного вызова обычно возвращают ненулевые значения, сообщая об успешном выполнении, и ноль, показывая сбой. В данном примере для продолжения перечисления в явном виде устанавливается возвращаемое значение true.
Создайте делегат и передайте его в качестве аргумента в функцию EnumWindows. Вызов неуправляемого кода автоматически преобразует делегат в знакомый формат обратного вызова.
Убедитесь, что сборщик мусора не выполняет уничтожение делегата до завершения выполнения функции обратного вызова. При передаче делегата в качестве параметра или как поля структуры он не уничтожается в течение всего вызова. Таким образом, как показано в следующем примере перечисления, функция обратного вызова завершает работу, прежде чем вызов возвращает управление, не требуя никаких дополнительных действий со стороны управляемого вызывающего объекта.
Но если функция обратного вызова может быть вызвана после возвращения вызова, управляемый вызывающий объект должен выполнить действия, гарантирующие, что делегат не будет удален, пока функция обратного вызова не завершит работу. Подробные сведения о предотвращении сборки мусора см. раздел Маршалинг взаимодействия с вызовом неуправляемого кода.
Пример
Imports System
Imports System.Runtime.InteropServices
Public Delegate Function CallBack( _
hwnd As Integer, lParam As Integer) As Boolean
Public Class EnumReportApp
Declare Function EnumWindows Lib "user32" ( _
x As CallBack, y As Integer) As Integer
Public Shared Sub Main()
EnumWindows(AddressOf EnumReportApp.Report, 0)
End Sub 'Main
Public Shared Function Report(hwnd As Integer, lParam As Integer) _
As Boolean
Console.Write("Window handle is ")
Console.WriteLine(hwnd)
Return True
End Function 'Report
End Class 'EnumReportApp
using System;
using System.Runtime.InteropServices;
public delegate bool CallBack(int hwnd, int lParam);
public class EnumReportApp
{
[DllImport("user32")]
public static extern int EnumWindows(CallBack x, int y);
public static void Main()
{
CallBack myCallBack = new CallBack(EnumReportApp.Report);
EnumWindows(myCallBack, 0);
}
public static bool Report(int hwnd, int lParam)
{
Console.Write("Window handle is ");
Console.WriteLine(hwnd);
return true;
}
}
using namespace System;
using namespace System::Runtime::InteropServices;
// A delegate type.
delegate bool CallBack(int hwnd, int lParam);
// Managed type with the method to call.
ref class EnumReport
{
// Report the window handle.
public:
[DllImport("user32")]
static int EnumWindows(CallBack^ x, int y);
static void Main()
{
EnumReport^ er = gcnew EnumReport;
CallBack^ myCallBack = gcnew CallBack(&EnumReport::Report);
EnumWindows(myCallBack, 0);
}
static bool Report(int hwnd, int lParam)
{
Console::Write(L"Window handle is ");
Console::WriteLine(hwnd);
return true;
}
};
int main()
{
EnumReport::Main();
}