Co to są biblioteki DLL? Za Wiki:
DLL (z ang. Dynamic-Link Library - biblioteka łączona dynamicznie) – w środowisku Microsoft Windows biblioteka współdzielona (z ang. shared library), która przechowuje implementacje różnych podprogramów programu lub zasoby programu. Podprogramy i zasoby zawarte w bibliotece DLL mogą być wykorzystane bezpośrednio lub pośrednio (za pośrednictwem innej biblioteki DLL) przez dowolny plik wykonywalny, sama biblioteka DLL nie jest samodzielnym programem.
Funkcje biblioteki dynamicznej (DLL) mogą być jednocześnie (w tym samym czasie) importowane przez wiele programów (stąd określenie: biblioteka współdzielona), dzięki temu pamięć operacyjna jest mniej obciążona. Biblioteki DLL mogą być importowane statycznie bądź dynamicznie. W przeciwieństwie do bibliotek statycznych, które są łączone z programem w czasie jego konsolidowania, biblioteki DLL importowane dynamicznie są oddzielnym fragmentem programu i ich modyfikacja nie wymaga przeprowadzenia ponownej konsolidacji, jednak problem z biblioteką (brak importowanych funkcji lub problem z wczytywaniem biblioteki) całkowicie uniemożliwia uruchomienie programu. Biblioteki importowane dynamicznie są wczytywane do pamięci operacyjnej dopiero w momencie określonym przez programistę (przeważnie gdy faktycznie są potrzebne) - stąd określenie: biblioteka dynamicznie łączona - przez co pliki DLL często są wykorzystywane w różnych programach jako wtyczki.
W systemie Microsoft Windows biblioteki DLL mają rozszerzenia .dll, .ocx (gdy biblioteka jest kontrolką ActiveX), .cpl (gdy biblioteka jest rozszerzeniem Panelu Sterowania), .drv (gdy jest przestarzałym sterownikiem), i mogą być wykorzystane w programach napisanych w różnych językach przeznaczonych na platformę Windows.
W AutoIt nie można tworzyć własnych bibliotek DLL (DLL można tworzyć tylko w językach kompilowanych takich jak C, C++, C#, D, VB, Delphi itp.), można za to korzystać z gotowych bibliotek.
W zasadzie większość funkcji AutoIt”a to nakładki na funkcje DLL systemu operacyjnego (np. wszystkie funkcje GUI).
DllCall Wywołanie funkcji z biblioteki dynamicznej DLL. DllCall ("dll", "typ_zwracany", "funkcja" [, typ1, param1 [, typN, paramN]]) Parametry:
dll - nazwa używanego pliku DLL. np. "user32.dll". Może być użyty uchwyt uzyskany funkcją DllOpen (patrz uwagi).
typ_zwracany - zwracany typ funkcji (patrz niżej).
funkcja - nazwa funkcji wywoływanej (np. "MessageBox") lub jej numer porządkowy (np. 62) w bibliotece DLL.
typ1 - [opcjonalnie] typ parametru 1 (patrz uwagi).
param1 - [opcjonalnie] wartość parametru 1 (patrz uwagi).
...
typN - [opcjonalnie] typ n-tego parametru (patrz uwagi).
paramN - [opcjonalnie] wartość n-tego parametru (patrz uwagi).
Prawidłowe typy: Typ | Szczegóły
none | żadna wartość (tylko dla wartości zwracanej - odpowiednik void w C)
BYTE | 8 bitowa (1 bajt) liczba całkowita bez znaku
BOOLEAN | 8 bitowa (1 bajt) liczba całkowita bez znaku
short | 16 bitowa (2 bajty) liczba całkowita ze znakiem
USHORT | 16 bitowa (2 bajty) liczba całkowita bez znaku
WORD | 16 bitowa (2 bajty) liczba całkowita bez znaku
int | 32 bitowa (4 bajty) liczba całkowita ze znakiem
long | 32 bitowa (4 bajty) liczba całkowita ze znakiem
BOOL | 32 bitowa (4 bajty) liczba całkowita ze znakiem
UINT | 32 bitowa (4 bajty) liczba całkowitą bez znaku
ULONG | 32 bitowa (4 bajty) liczba całkowitą bez znaku
DWORD | 32 bitowa (4 bajty) liczba całkowitą bez znaku
INT64 | 64 bitowa (8 bajtów) liczba całkowita ze znakiem
UINT64 | 64 bitowa (8 bajtów) liczba całkowita bez znaku
ptr | ogólny wskaźnik, 32 lub 64 bitowa liczba całkowita bez znaku | (w zależności od wersji AutoIt - x86 lub x64)
HWND | uchwyt okna (wskaźnik), 32 bitowa liczba całkowita
HANDLE | uchwyt (wskaźnik), 32 bitowa liczba całkowita
float | 32 bitowa liczba zmiennoprzecinkowa
double | 64 bitowa liczba zmiennoprzecinkowa podwójnej precyzji
INT_PTR | liczba całkowita wystarczająco duża, aby przechowywać wskaźnik LONG_PTR | (32 lub 64 bitowy, zależnie od wersji AutoIt) LRESULT | lParam | UINT_PTR | ULONG_PTR | DWORD_PTR | WPARAM |
str | string ANSI (maksymalnie 65536 znaków)
wstr | string UNICODE (maksymalnie 65536 znaków)
struct | struktura stworzona przez DllStructCreate()
* | dodanie * na końcu opisu typu oznacza przekazanie parametru | przez referencję (np. "int*")
Konwersje z typów systemu Windows API do typów AutoIt: Typ API | Typ AutoIt
LPCSTR / LPSTR | str
LPCWSTR / LPWSTR | wstr
LPVOID | ptr
LPxyz | xyz*
HINSTANCE | handle
HRESULT | long
LONGLONG / LARGE_INTEGER | INT64
ULONGLONG / ULARGE_INTEGER | UINT64 SIZE_T | ULONG_PTR
Zwracana wartość:
Sukces: tablica wyników:
$array = wartość zwracana przez funkcję
$array = param1
$array = param2
...
$array [n] = paramN
@error = 0.
Błąd: makro @error przyjmuje wartość:
1 nie można użyć pliku DLL
2 nieznany "typ_zwracany"
3 "funkcja" nie znajduje się w pliku DLL
4 zła ilość parametrów
5 zły parametr
Uwagi:
Jeżeli podamy nazwę pliku DLL, biblioteka jest ładowana automatycznie, a następnie zamykana po zakończeniu wywołania.
Jeśli chcemy ręcznie sterować ładowaniem DLL należy użyć funkcji DllOpen i DllClose, oraz używać uchwyt zamiast nazwy pliku.
Aby móc korzystać z bibliotek DLL należy dokładnie poznać sposób wywoływania zawartych w nich funkcji. Dla bibliotek systemowych Windows bardzo pomocna będzie witryna MSDN.
http://msdn.microsoft.com/en-us/windows/desktop - Strona MSDN http://msdn.microsoft.com/en-us/library/aa383686%28VS.85%29.aspx - Strona MSDN Functions by Category
DllCallAddress Dynamiczne wywołanie funkcji pod określonym adresem pamięci. DllCallAddress ("typ_zwracany", adres [, typ1, param1 [, typN, paramN]]) Opis jak dla DllCall().
Ostrzeżenie: Jest to zaawansowana funkcja. Niepoprawne użycie może spowodować awarię Autoita.
Przed skorzystaniem z tej funkcji upewnij się, że musisz jej użyć ponieważ DllCall() nie robi tego, czego oczekujesz.
DllOpen Otwiera plik DLL do użycia przez DllCall. DllOpen ("nazwa_pliku") Parametry:
nazwa_pliku - nazwa otwieranego pliku DLL.
Wartość zwracana:
Sukces: uchwyt (handle) do biblioteki DLL.
Błąd: -1
Uwagi:
Po zakończeniu pracy z biblioteką DLL, należy zamknąć ją przy użyciu funkcji DllClose.
Autoita wprawdzie zamyka wszystkie pliki po zakończeniu działania skryptu, ale lepiej jawnie użyć DllClose.
DllClose Zamyka wcześniej otwarty DLL. DllClose (dll_handle) Parametry: dll_handle - uchwyt do DLL, zwracany przez wywołaną wcześniej funkcję DllOpen.
Funkcja nie zwraca żadnej wartości.
Przykład (wywołanie MsgBox bezpośrednio z DLL): Local $dll = DllOpen("user32.dll") Local $result = DllCall($dll, "int", "MessageBox", "hwnd", 0, "str", "Nazwa okna", "str", "Jakiś tekst", "int", 0) DllClose($dll)
Co to jest struktura? Struktura lub rekord - to złożony typ danych występujący w wielu językach programowania, grupujący logicznie powiązane ze sobą dane różnego typu w jednym obszarze pamięci. Składowe struktury - pola - są etykietowane, tj. mają swoje unikatowe nazwy; poprzez podanie nazwy otrzymuje się dostęp do danego pola.
Struktury są wykorzystywane między innymi do wymiany danych pomiędzy skryptem, a funkcjami DLL.
Ponieważ AutoIt w zasadzie nie zawiera typu rekordowego danych, struktury nie są tworzone bezpośrednio, lecz za pośrednictwem odpowiedniej funkcji (DllStructCreate()) i stringu z opisem ich budowy. Także manipulowanie strukturami odbywa się za pośrednictwem specjalnie przeznaczonych do tego funkcji.
DllStructCreate Tworzy strukturę danych w stylu C / C + +, do zastosowania w wywołaniu DllCall. DllStructCreate (struktura [, wskaźnik]) Parametry:
struktura - ciąg znaków reprezentujący tworzoną strukturę (patrz uwagi).
wskaźnik - [opcjonalnie] wskaźnik do tworzonej struktury danych, jeżeli strukturę chcemy stworzyć w określonym miejscu pamięci.
Wartość zwracana:
Sukces: string ze strukturą do użycia w wywołaniach DllStruct (@error = 0)
Błąd: 0 (makro @error przyjmie wartość:)
1 – wartość przekazana do DllStructCreate nie jest łańcuchem (stringiem)
2 - nieznany typ danych w przetwarzanym łańcuchu
3 - nie udało się przydzielić pamięci potrzebnej do struktury lub pointer = 0
4 - błąd przydzielania pamięci dla przetwarzanego łańcucha
Typ | Szczegóły
BYTE | 8 bitowa liczba całkowita bez znaku
BOOLEAN | 8 bitowa liczba całkowita bez znaku
CHAR | 8 bitowy kod ASCII
WCHAR | 16 bitowy kod UNICODE
short | 16 bitowa liczba całkowita ze znakiem
USHORT | 16 bitowa liczba całkowita bez znaku
WORD | 16 bitowa liczba całkowita bez znaku
int | 32 bitowa liczba całkowita ze znakiem
long | 32 bit liczba całkowita ze znakiem
BOOL | 32 bit liczba całkowita ze znakiem
UINT | 32 bitowa liczba całkowita bez znaku
ULONG | 32 bitowa liczba całkowita bez znaku
DWORD | 32 bitowa liczba całkowita bez znaku
Int64 | 64 bitowa liczba całkowita ze znakiem
UINT64 | 64 bitowa liczba całkowita bez znaku
ptr | 32 lub 64 bitowa całkowita bez znaku | (w zależności od wersji AutoIt - x86 lub x64)
HWND | 32 bitowa liczba całkowita
HANDLE | 32 bitowa liczba całkowita
float | 32 bitowa liczba zmiennoprzecinkowa
double | 64 bitowa liczba zmiennoprzecinkowa
INT_PTR | 32 lub 64 bitowa całkowita bez znaku LONG_PTR | (w zależności od wersji AutoIt - x86 lub x64) LRESULT | lParam |
UINT_PTR | 32 lub 64 bitowa całkowita bez znaku ULONG_PTR | (w zależności od wersji AutoIt - x86 lub x64) DWORD_PTR | WPARAM |
Uwagi:
Każdy typ danych musi być oddzielony średnikiem ';'.
Możliwe jest tworzenie tablic poprzez dodanie "[rozmiar]" po typie danych, np.: DllStructCreate ("int; char ").
Nazwę elementu można dodać podobnie do deklaracji w C, np. : DllStructCreate ("int n; char buffer").
Tą nazwę można używać w następnych wywołaniach funkcji DllStruct … Nazwa może składać się jedynie ze znaków alfanumerycznych i podkreślenia.
Aby zwolnić przydzieloną pamięć wystarczy ustawić zmienną na 0.
Przykład tworzenia struktur: ;struktura bez nazw elementów $struct1=DllStructCreate("int; char; ptr; byte") ;struktura z nazwami elementów $struct2=DllStructCreate("int n; char s_1; ptr p1; byte l")
DllStructSetData Nadaje wartość elementowi w strukturze. DllStructSetData (struktura, element, wartość [, indeks]) Parametry:
struktura - struktura danych zwrócona przez DllStructCreate.
element - do którego elementu struktury chcemy uzyskać dostęp, nr elementu (numeracja od 1) lub nazwa zdefiniowana w DllStructCreate.
wartość - nowa wartość elementu struktury.
indeks - [opcjonalnie] dla elementów będących tablicami określa indeks komórki, której wartość będzie ustawiana. Jeżeli parametr pominiemy lub podamy jako Default, domyślny indeks początkowy wyniesie 1, a następnie ustawionych zostanie tyle komórek, ile jest podanych wartości, np.: DllStructSetData($st, tab, 'AutoIt', Default). Jest to przydatne do szybkiego ustawiania stringów. Parametr nie jest używany dla elementów nie będących tablicami.
Wartość zwracana:
Sukces: wartość, która jest ponownie odczytywana ze struktury (makro @error = 0)
Błąd: 0 (makro @error ustawione na:)
1 – nieprawidłowa struktura
2 – element po za zakresem
3 – indeks po za zakresem
4 – nieznany typ danych
5 – indeks <=0
Uwagi:
Kiedy element jest typu char [n], byte [n] lub ubyte [n] dane mogą być stringiem, w przeciwnym razie muszą być liczbą.
Przykład: $struct1=DllStructCreate("int; char; ptr; byte") $struct2=DllStructCreate("int n; char s_1; ptr p1; byte l") ;nadanie wartości przez numer elementu DllStructSetData($struct1,1,666) ;nadanie wartości przez nazwę DllStructSetData($struct2,"s_1","AutoIt")
DllStructGetData Zwraca wartość elementu struktury. DllStructGetData (struktura, element [, indeks]) Parametry:
struktura - struktura danych zwrócona przez DllStructCreate.
element - do którego elementu struktury chcemy uzyskać dostęp (numeracja rozpoczyna się od 1), lub nazwa elementu ustalona w DllStructCreate.