Что такое и зачем lpNumberOfBytesWritten в WINAPI функции WriteFile?

Question

[LoliDeveloper]

BOOL WriteFile(
  [in]                HANDLE       hFile,
  [in]                LPCVOID      lpBuffer,
  [in]                DWORD        nNumberOfBytesToWrite,
  [out, optional]     LPDWORD      lpNumberOfBytesWritten,
  [in, out, optional] LPOVERLAPPED lpOverlapped
);

Не понимаю за что тут отвечает четвёртый параметр. Это указатель на переменную, хранящую колличество записанных байт, но в примере тут просто какая-то магия и ничего не объясняется, как эти байты хранятся и откуда они там вообще берутся.
asm - NASM

; DWORD  bytes;    
    mov     ebp, esp
    sub     esp, 4

    ; hStdOut = GetstdHandle( STD_OUTPUT_HANDLE)
    push    -11
    call    _GetStdHandle@4
    mov     ebx, eax    

    ; WriteFile( hstdOut, message, length(message), &bytes, 0);
    push    0
    lea     eax, [ebp-4] ; ВОТ ЭТА СТРОКА ЭТО ЧТО? ПОЧЕМУ ТАК?
    push    eax ; и тут он передаёт как четвёртый аргумент. 
    push    (message_end - message)
    push    message
    push    ebx
    call    _WriteFile@20

Comments

[Wataru]

Там же написано:
[out, optional]

Что касается ассемблерра, то там в eax загружается адрес локальной переменной (на стеке) и этот указатель пихается в стек - таким образом передается параметром в функцию.

Поскольку он optional, можете смело передавать nullptr, если вам не нужно контролировать ошибки.

Answer 1

[Rsa97]

Дык английским же по белому написано - long pointer на переменную, в которой вернётся количество записанных байт.

Comments

[LoliDeveloper]

Аааа, это куда сама функция это вернёт. Боже.
Я думал это мне надо что-то туда класть и давать ей на использование. Спасибо.