Calling stdcall and cdecl functions from DLLs and function pointers. (draft)

Transcription

1 Calling stdcall and cdecl functions from DLLs and function pointers. (draft) ot4xb.dll provide support for calling function pointers, usually obtained from a DLl exported function, but also from a COM interface or any other API As the values of the parameters and return types not matching with the Xbase++ types, a type conversion is required in all cases. ot4xb.dll provide 2 ways to convert the provided values and return types: Inferring the required type from the provided Xbase++ values: nfpcall() when the return value is a 32 bit value and ndfpcall(), qwfpcall() when the return value is double or int64. Using a prototype string describing how to convert the provided parameters and also the returned value. FpQCall() for stdcall and cdecl functions, and IFpQCall() for COM interfaces

2 nfpcall(),ndfpcall(),qwfpcall() Call a STDCALL or CDECL function returning a 32 bit value from a provided pointer, converting the parameters as required. nfpcall( <fp>, params... ) -> n32bitresult ndfpcall( <fp>, params... ) -> n64bitfloatresult qwfpcall( <fp>, params... ) -> n64bitint Parameters: <fp> If numeric must be a function pointer like the result of ngetprocaddress(). If a string must be the result of DllPrepareCall() <params... > Required parameters of the called function. Return Value: nfpcall() will return always a 32 bit integer value. BOOL functions will return 0 when.f. or any other value meaning.t. Notes: If the function returns a 32 bit float value you must convert it using UnPackFloat32() To get 64 bit integer values use qwfpcall(). To get 64 bit float values use ndfpcall(). Calling conventions: This function support CDECL and STDCALL calling conventions. The calling convention is detected on the fly and the stack are restored according with the right calling convention. FASTCALL and THISCALL are not supported by this function.

3 Parameter type conversion: <Xbase++ LOGICAL by value> The value of the parameter will be passed as BOOL to the called function. <Xbase++ LOGICAL by reference> A reference pointer to this parameter will be passed as BOOL* to the called function and updated when the function return. <Xbase++ NUMERIC by value> The value of the parameter will be passed as LONG to the called function. Decimal values will be truncated. You can call also parameters prototyped as shorter values like WORD, int16, BYTE or CHAR because CDECL and STDCALL pass the values in 32 bit packs, so the high part will be ignored in this cases. <Xbase++ NUMERIC by reference> A reference pointer to this parameter will be passed as LONG* to the called function and updated when the function return. If you call parameters prototyped as pointer to shorter values like WORD*, int16*, BYTE* or CHAR* you will need to adjust the result manually after the call using functions LoWord() or LoByte() <Xbase++ CHARACTER by value> The value of the parameter will be passed as a READ-ONLY BUFFER ( LPCSTR ) to the called function. <Xbase++ CHARACTER by reference> The value of the parameter will be passed as a READ-WRITE BUFFER ( LPSTR ) to the called function. Providing 64 bit integer parameters: NIL + <Xbase++ CHARACTER by value> This a special case used to provide int64 values to the called function. In this case the string MUST have 8 BYTES corresponding to the binary reprentation of the 64 bit integer. You can convert numeric double values to a 64 bit binary integers using the function Double2LongLong()

4 NIL + <Xbase++ CHARACTER by reference> Same as above but the value will be passed as int64* and the result will be writed back after the functions returns. Providing float double values: NIL + <Xbase++ NUMERIC by value> This a special case used to provide float double values to the called function. NIL + <Xbase++ NUMERIC by reference> Same as above but the value will be passed as double* and the result will be writed back after the functions returns. Providing 32 bit float values: You can provide 32 bit float values packed as Xbase++ numeric values with the function PackFloat32() or pointer to 32 bit float passing them by reference. OT4XB Extended pointers: OT4XB allow you to provide pointers to structures in an easy way using arrays and objects. <Xbase++ ARRAY of NUMERICs> If you provide an Xbase++ array of numeric values will be passed to the called function as buffer containing an array of int32 values. If passed by reference the buffer values will be written back to your array. <OT4XB GWST OBJECTs > If you provide a GWST subclass instance like created with structure commands the pointer to the struture will be provided to the called function.

5 FpQCall() Call a STDCALL or CDECL function using a character template describing the function prototype, so the provided parameters will be transformed ( in and out) according with this prototype, and also the return value will be retrieved from the correct place according with the prototype. FpQCall( <fp>,<prototype>,params... ) -> n32bitresult Parameters: <fp> If numeric must be a function pointer like the result of ngetprocaddress(). If a string must be the result of DllPrepareCall() <prototype> String composed by 4 characters describing tghe return value and 4 characters for each parameter to describe the corresponding required types. <params... > Required parameters of the called function.

6 Prototype templates for FpQCall and IFpQCall() template type " vo" VOID... xb PXBASEVAR bo BOOL sc INT8 uc BYTE ss INT16 us WORD sl INT32 ul DWORD sq INT64 uq QWORD f4 FLOAT f8 DOUBLE pt PSL_OR_PT LPBOOL LPINT8 LPUINT8 LPINT16 LPWORD LPINT32 LPDWORD LPINT64 LPQWORD LPFLOAT LPDOUBLE c_sw STR2WIDE STR2WIDE_W c_sz ZSTRING hw HWND vt VARIANT

7 ...

8 SOME RELATED MISCELANEOUS FUNCTIONS nfpgetlasterror() Return the winapi LastError() value for the latest *fpcall() execution on the same thread nfpgetlasterror() -> nerrcode ngetprocaddress() Return the function pointer of an exported function from the specified DLL or 0 if not found. ngetprocaddress( hdll, cfuncname ) -> fp AppInstance() Return the module handle of the current process. AppInstance() -> hinstance GethKernel32(),GethUser32(),GethShell32(),GethOt4xb() Return the module handle of the kernel32.dll,user32.dll,shell32.dll and ot4xb.dll.