MIDL示例【转】

最新推荐文章于 2021-04-17 12:51:50 发布

转载最新推荐文章于 2021-04-17 12:51:50 发布 · 1.3k 阅读

文章标签：

#interface #library #编译器 #microsoft #object #dll

【转】 http://hi.baidu.com/it_new/blog/item/a2f5cd4e58af1b0ab2de05f9.html

MIDL示例

2007-11-29 02:01

IDL是接口定义语言。MIDL是Microsoft的IDL编译器。在用IDL对接口和组件进行了描述后，可以用MIDL进行编译，生成相应的代理和存根DLL的C代码。

import “unknown.idl”
///Interface IX
[
       object,
       uuid(32bb8323-b41b-11cf-a6bb-0080c7b2d682),
       helpstring(“IX Interface”),
       pointer_default(unique)
]

interface IX:IUnknown
{

HRESULT FxStringIn([in,string]wchar_t* szIn);
HRESULT FxStringOut([out,string]wchar_t* szout);

}

import

用于将其他idl文件中的定义包含到当前文件中。

object：

表示所定义的接口是一个COM接口，关键字object是Microsoft对于IDL的一种扩展；

uuid(32bb8323-b41b-11cf-a6bb-0080c7b2d682)：

表示相应的IID；

helpstring(“IX Interface”)：

将一个帮助串放到一个类型库中；

pointer_default(unique) ：

告诉MIDL编译器在没有为指针指定其他属性的时候如何处理该指针；可以当作引用、指针或空等，具体参见《COM技术内幕》第204页；

in关键字告诉MIDL需要将此参数值从客户传递给组件，存根代码不需要送回任何值。

out关键字告诉MIDL参数仅被用来从组件向客户传回有关的数据，

COM对字符串的标准约定是Unicode字符（即wchar_t）；IDL文件可以定义C和C++风格的结构，并可用它们作为函数的参数。

当IDL文件中有一个library时，MIDL将生成一个类型库。L为接口生成相应的代理和存根的C代码。
为得到一个代理/存根DLL，需要编译和链接MIDL生成的C文件。
宏REGISTER_PROXY_DLL将完成代理/存根DLL在注册表中的注册操作。
有了IDL和MIDL我们就可以象调用进程内组件那样进行跨进程边界的函数调用，并对参数进行列集。

当IDL文件定义了library的时候，MIDL将会生成一个类型库，该类型库包括了在library block中每个元素的定义，以及在block外定义但在该bloack中引用元素的定义。

You can use a single IDL file to generate both the proxy stubs and header files for marshaling code, and a type library. You do this by defining an interface outside the library block and then referencing that interface from inside the library block.

 MIDL编译器将生成XX.H XX_.C XX_P.C DLLDATA.C几个文件，其作用分别为：

XX.H        一个同C和C++兼容的，包含IDL中所描述的所有接口声明的头文件；

XX_.C      一个定义有IDL文件中所用的所有GUID的C文件

XX_P.C      一个实现IDL文件中接口的代理及残根的C文件

DLLDATA.C 一个包含代理和残根的DLL的C文件

---------------------------------------------------------------------------------------------

-------------------------------------------------------------------------------------------

import "unknwn.idl"; 
[ object,uuid(9955EBD9-C24D-4b18-9D88-D6049ADDCBC8) ]
interface ICalculator : IUnknown {
 HRESULT Add ( [in] long v1, [in] long v2, [out, retval] long* pVal );
 HRESULT Subtract ( [in] long v1, [in] long v2, [out, retval] long* pVal );
 HRESULT Multiply ( [in] long v1, [in] long v2, [out, retval] long* pVal );
 HRESULT Divide ( [in] long v1, [in] long v2, [out, retval] long* pVal );
}

 
[ uuid(F1B9F274-5B16-4033-BECD-9C05BB6072AE) ]
library CalcualtorLib
{  
 [ uuid(0A6C37B3-3577-48a7-9485-5F10ED190ECF) ]
 coclass CCalculator
 { 
   interface ICalculator;
 }
};

笔者在编译上面的IDL文件时,产生下列错误:

D:/Work/Math/Calculator.idl(3) : error MIDL2311 : statements outside library block are illegal in mktyplib compatability mode : [ Interface 'ICalculator'  ]
D:/Work/Math/Calculator.idl(3) : error MIDL2096 : duplicated attribute : [uuid] [ Interface 'ICalculator'  ]
Error executing midl.exe.

察看MSDN,发现原因是：

      
           需要在project中将IDL文件的MIDL/mktyplib203选项去掉.

【示例2】

所有数据、方法、接口、类和库的特性都由属性信息来描述。属性信息中由括号括起来，作为它们描述的对象的前缀。

[in] : 告诉MIDL编译器生成代码时，只是把从客户到对象的数据列集，没必要把同样的数据列集送回给客户

[out] : 让一段数据从对象返回到客户。
-------------------------------------------------------------------------
IUnknown接口定义
import "unknwn.idl";
[ local,object
   uuid(FAEAE6B7-67BE-42a4-A318-3256781E945A),
   pointer_default(unique)
]
interface IUnknown
{
    typedef(unique) IUnknown *LPUNKNOWN

    cpp_quote("/////////////////////////////////////////////")
    cpp_quote("//IID_IUnknown和其他所有的系统IID都是由UUID.LIB提供的")
    cpp_quote("//把这个函数库与你的代理、客户和服务链接起来")
    cpp_quote("/////////////////////////////////////////////")

HRESULT QueryInterface( [in] REFIID iid,
[out,iid_is(riid)] void **ppObject );

ULONG AddRef();
ULONG Release();
}
-----------------------------------------------------------------------------
[object] : 指定接口是一个com接口。如果遗漏这个属性信息，那IOcr接口只是一个简单的MS RPC接口；如果没有这个属性信息，所生成的列集代码将与COM函数库（运行时）提供的标准列集代码不兼容。

[UUID] : 这是IOcr接口静态的和唯一的IID，它是一个在时间上和空间上独一无二的机器生成数字。

[local] : 告诉MIDL编译器,不要生成接口代理和存根。

[pointer_default()] : 设定了所有还没有显示限定的嵌入式指针（embedded pointer）的默认指针属性信息。嵌入式指针（embedded pointer）包括结构体（structrue）、联合体（union）、数组（array）的成员指针.

unique属性信息：1)[ref]指针是引用指针（reference pointer），不能为空。
2)[unique]指针是简单指针（simple pointer），可以为空。但是代理不提供对重复指针探测的支持。例如，若ptr1/ptr2都

指向同一个数据，那个数据的两份相同的副本会被送往远程对象。
3)[ptr]指针是完全指针（full pointer）。若ptr1/ptr2都指向同一个数据，只有一个副本会被送往远程对象。

cpp_quote：指导MIDL编译器将限定了的字符串转换成生成的头文件。具体来说，这四行会在MIDL编译器生成的头文件中做出C++的注释。

[iid_is()] : 这是一个指针属性，它与[ptr][ref][unique]相似，只适用于指针。iid_is(riid)属性列集器关心，实际上，存根需要准确地知道正在调度的接口指针（riid,某种IID）

[size_is()] : 显示地告诉列集器，指针实际指向一些字节的块。列集器根据这个块的大小分配内存。

[string] : 提示列集器：修饰的本参数是一个字符串，是以null终止的。