创建COM对象（翻译）

创建COM对象

   有几种方法可以用来创建COM对象。有两种最常用的方法用来创建DirectX程序，他们是：
   1、直接方式。通过传递对象的CLSID给CoCreateInstance函数。这个函数创建对象的一个实例，并且返回你所指定的那个接口的指针。
   2、间接方式。通过呼叫DirectX的一个方法或一个函数来为你创建一个对象。这个方法创建一个对象并且返回在这个对象上的一个接口。当你通过这种方式创建一个对象的时候，通常你不能指定返回那一个接口。

   在创建任何对象之前，COM必须呼叫CoInitialize函数进行初始化。假如你用间接的方法创建一个对象，创建这个对象的方法将会自动执行这个初始化。假如你用CoCreateInstance创建这个对象
，你必须明确的呼叫CoInitialize以便进行初始化。当不再使用对象的时候，COM必须呼叫CoUninitialize进行清除初始化。假如你呼叫了CoInitialize，你就必须成对的呼CoUninitialize
.通常，应用程序需要在它的启动例程里面初始化COM对象，而在清除例程里面卸载COM对象。

  
   用CoCreateInstance新创建一个COM对象的事例，你必须有对象的CLSID。假如CLSID是公开可以使用的，你可以在参考文档或适当的头文件中找到它。假如CLSID不是公开使用的，那么你就不能用这种直接的方式创建这个对象。

   CoCreateInstance这个函数有5个参数。COM将被用于DirectX，通常，你能像下面那样设置这些参数：
  
   ●rclsid参数：这个参数设置你想创建的那个对象的CLSID.
   ●pUnkOuter参数：这个参数设置为NULL.当你聚合对象时，这个对象被使用。
   ●dwClsContext参数：这个参数设置为CLSCTX_INPROC_SERVER.这样设置这个参数表明这个对象在DLL中被实现，它将作为程序进程的一部分被运行。
   ●riid参数：这个参数设置你想要返回的接口的IID。这个函数将创建一个对象，并且在ppv这个参数中返回你所请求的接口的指针。
   ●ppv参数：在这个函数返回的时候，这个参数存放在riid中指定的那个接口的指针的地址。这个变量应该被声明为指向请求接口的指针。

   例如：下面的代码段创建了一个DirectPlay8的对象的实例，并且在g_pDP变量中返回一个指向IDirectPlay8Peer接口的指针。假如出现错误，将显示一个对话框，并且程序终止运行。

   IDirctPlay8Peer * g_pDP = NULL ;
   ...
   CoInitialize( NULL ) ;
   ...
   hr = CoCreatInstance( CLSID_DirectPlay8, NULL, CLSCTX_INPROC_SERVER,
                         IID_IDirectPlay8Peer, (LPVOID *)&g_pDP ) ;
  
   if( FAILED( hr ) )
   {
     MessageBox( NULL, TEXT( "Failed Creating IDirectPlay8Peer." ),
                  TEXT( "DirectPlay Sample" ), MB_OK | MB_ICONERROR ) ;
     return FAISE ;
   }

   用间接的方法创建一个对象非常的简单。只需将一个接口的指针传递给创建这个对象的方法即可。然后这个方法就会创建这个对象并且返回指向这个接口的指针。当你用间接的方法创建一个对象的时候，通常你不能选择返回哪一个接口，然而，你却可以指定如何创建这个对象的一些事情。例如：下面的代码段呼叫IDirect3D8::CreateDevice方法论述创建一个设备对象用来代表显示适配器。它将返回一个指向对象的IDirect3DDevice8接口的指针。这个函数的前4个参数提供了创建这个对象所需要的各种信息，第5个参数用来接受接口指针。要得到更详细的信息请参考文档。

   IDirect3DDevice8 *g_pd3dDevice = NULL ;
   ...
   if( FAILED( g_pD3D->CreateDevice( D3DADAPTER_DEFAULT,
                                     3DDEVTYPE_HAL,
                                     hWnd,
                                     D3DCREATE_SOFTWARE_VERTEXPROCESSING,
                                     &d3dpp,
                                     &g_pd3dDevice )))

   return E_FAIL ;

 

 

注: 由于翻译水平有限，错误在所难免。如发现翻译的不对的地方还请路上的朋友指正，谢谢

可以任意转载。

译者： closeall

 

2005.09.04 译