Addressing modes.

The aim of the exercise is to learn about x64 processor addressing modes. The design of the project assumes the possibility of calling library functions written in assembler from the application level and shows the correct configuration of the environment enabling debugging code to assembler level, observing the state of registers and flags of the processor or data memory areas. Another aim of the exercise is to learn the methods of arguments passing to the procedures and techniques for measuring machine code execution time.

The following code is divided into two parts. The C++ part calls the functions in a dynamically linked library. One function, called FindChar_1() searches for the “J” character in a string. The string is defined inside the DLL. Another function ReadTime_1() measures the execution time of the first function.

C++ file

#include <iostream>
#include <windows.h>

typedef int(_stdcall* MyProc)();
HINSTANCE dllHandle = NULL;

int main()
{
    std::cout << "Hello World!\n";
    dllHandle = LoadLibrary(TEXT("JaAsm.dll"));
    std::cout << procedura();

    MyProc FindChar = (MyProc)GetProcAddress(dllHandle, "FindChar_1");
    MyProc ReadTime = (MyProc)GetProcAddress(dllHandle, "ReadTime_1");

    char szString[] = { 'A','G','I','K','S','Z','J', 0xFF }; // string definition 
    printf("FindChar_1 %s\n", (FindChar() == 1 ? "Found J" : "Not Found J"));
    printf("Processing time: %i\n", ReadTime());
}

Assembler dll file.

;****************************************************************************
;   String definition
;****************************************************************************
.data 
DataString DB 'AGIKSZJ', 0FFH; string definition  

.code
;****************************************************************************
;   Procedure to find the character in a string
;   No input parameters, result is 1 if character found, 0 otherwise
;****************************************************************************
FindChar_1 PROC 
    PUSH RSI
    LEA RSI, DataString      ; load the address of variable 'DataString' into reg. ESI 
    MOV AL, 'J'              ; load the code of character 'J' into reg. AH 
Check_End: 
    CMP BYTE PTR [RSI], 0FFH ; is it the end of a string (special character FF)? 
    JE Not_Find              ; found end character (guard) 
    CMP AL, [RSI]            ; compare a character with chosen char of string 'DataString' 
    JE Got_Equal             ; character found! 
    ADD RSI, 1               ; increment an offset
    JMP Check_End            ; search loop 
Got_Equal: 
    MOV DL, [RSI]            ; load found char into DL 
    JMP Done 
Not_Find: 
    MOV RAX,0                ; character not found 
    POP RSI
    RET                      ; return from procedure 
Done: 
    MOV RAX,1                ; character found
    POP RSI
    RET                      ; return form procedure
FindChar_1 ENDP              ; end of FindChar_1 

;****************************************************************************
;   Procedure to measure the time of other function execution
;   No input parameters, result is the time (number of processor ticks)
;**************************************************************************** 
ReadTime_1 PROC
    RDTSC                    ; read of time stamp counter
    MOV RCX,RAX

    CALL FindChar_1          ; call to the tested function

    RDTSC
    SUB RAX,RCX

    RET                      ; return form procedure
ReadTime_1 ENDP 

END
;**************************************************************************** 
    End of the file
;****************************************************************************