SDL_HitTestResult SDL_HitTest(SDL_Window*      win,
                              const SDL_Point* area,
                              void*            data)

gdzie SDL_HitTest jest nazwą twojej funkcji, a jej parametrami są:

Funkcja callback powinna zwracać SDL_HitTestResult.

Zwykle okna są przeciągane i modyfikowane rozmiarowo za pomocą elementów udostępnianych przez menadżera okien (pasek tytułowy, brzegi, itp.), lecz dla niektórych aplikacji sensowne jest przesuwanie okien z innego miejsca gdzieś wewnątrz samego okna, na przykład, można mieć okno bez brzegów, które powinno być przesuwane z jego dowolnego punktu, lub symulować jego własny pasek tytułowy, itp.

Ta funkcja umożliwia aplikacji dostarczenie własnej funkcji wywoływanej zwrotnie, która oznaczy części danego okna jako specjalne. Będzie ona wywoływana podczas przetwarzania zdarzeń, gdy wystąpi potrzeba poinformowania systemu operacyjnego, aby traktował pewien obszar okna w sposób szczególny; używanie takiej funkcji znane jest pod nazwą "testowania trafienia" (ang. hit testing).

Dane z myszki mogą nie zostać dostarczone do twojej aplikacji, jeśli wystąpią wewnątrz specjalnego obszaru; system operacyjny często zastosuje je do przesuwania okna lub do zmiany jego rozmiaru i nie dostarczy ich do aplikacji.

Określenie NULL jako callback wyłącza testowanie trafień, które jest wyłączone standardowo.

Na platformach nie obsługujących tej opcji funkcja zwraca -1 bezwarunkowo, nawet przy próbie wyłączenia testowania trafień.

Twoja funkcja callback może zostać wywołana w dowolnym momencie, a jej wywołanie nie oznacza żadnego specyficznego zachowania (na przykład w Windows zostanie ona na pewno wywołana, gdy system operacyjny decyduje, czy przeciągnąć twoje okno, lecz jest również wywoływana z mnóstwa innych powodów, a niektóre z nich są niezwiązane z niczym, na czym ci prawdopodobnie zależy, oraz gdy myszka nie jest właściwie w miejscu testowania). Zatem ponieważ funkcja może zostać wywołana w dowolnej chwili, powinieneś jej kod jak najbardziej optymalizować, unikając wielu alokacji pamięci itp.