COM笔记-CoCreateInstance

COM笔记-CoCreateInstance 很有用的 开发参考 比如 CoCreateInstance(CLSID_VideoRenderer,0,CLSCTX_ALL,IID_IBaseFilter,(void**)&pPreview);这里面的参数是什么意思 ？这个文档可以告诉你。。 欢迎联系：393877568 ### COM笔记-CoCreateInstance #### 一、概述 在组件对象模型（Component Object Model, COM）中，`CoCreateInstance` 是一个非常重要的函数，它主要用于创建 COM 组件的实例。本文将详细介绍 `CoCreateInstance` 函数的使用方法、各个参数的意义以及如何通过这个函数来管理组件的生命周期。 #### 二、`CoCreateInstance` 函数详解 `CoCreateInstance` 的原型如下： ```cpp HRESULT StdCall CoCreateInstance( REFCLSID rclsid, LPUNKNOWN pUnkOuter, DWORD dwClsContext, REFIID riid, LPVOID * ppv ); ``` - **第一个参数 (`REFCLSID rclsid`)**： - 描述：这是一个引用到 CLSID 类型的对象，用于指定要创建的组件的类 ID。 - 示例：假设我们要创建一个视频渲染器的实例，则可以通过传递 `CLSID_VideoRenderer` 来实现。 - **第二个参数 (`LPUNKNOWN pUnkOuter`)**： - 描述：此参数通常设置为 NULL，除非你需要进行聚合。如果需要进行聚合，则应该传递指向外部 `IUnknown` 接口的指针。 - 示例：在本例中，我们通常传递 NULL，表示不进行聚合。 - **第三个参数 (`DWORD dwClsContext`)**： - 描述：这个参数用于控制创建的组件实例的上下文。它可以是一个或多个 `CLSCTX` 常量的组合，这些常量定义了组件运行的位置（例如在同一个进程中、不同的进程中或远程计算机上）。 - 示例：例如，`CLSCTX_INPROC_SERVER` 表示组件将在客户端进程内部运行；而 `CLSCTX_LOCAL_SERVER` 则表示组件将作为独立进程运行在同一台计算机上。 - **第四个参数 (`REFIID riid`)**： - 描述：这是一个引用到 IID 类型的对象，用于指定希望从组件获取的接口的 ID。 - 示例：在本例中，我们需要获取 `IBaseFilter` 接口，因此会传递 `IID_IBaseFilter`。 - **第五个参数 (`LPVOID * ppv`)**： - 描述：这是一个指向 void 指针的指针，用于接收新创建的组件实例。 - 示例：在实际代码中，我们通常会传递一个指向所需接口类型的指针，例如 `(IBaseFilter**)&pPreview;`。 #### 三、`CoCreateInstance` 的实现原理 下面是一个简化版本的 `CoCreateInstance` 实现示例： ```cpp HRESULT CoCreateInstance( const CLSID& clsid, IUnknown* punkOuter, DWORD dwClsContext, const IID& riid, void** ppv) { // Set the output parameter to NULL *ppv = NULL; // Create the class factory and get an IClassFactory interface pointer. IClassFactory* pIFactory = NULL; HRESULT hr = CoGetClassObject(clsid, dwClsContext, NULL, IID_IClassFactory, (void**)&pIFactory); if (SUCCEEDED(hr)) { // Create the component. hr = pIFactory->CreateInstance(punkOuter, riid, ppv); pIFactory->Release(); } return hr; } ``` #### 四、`CoCreateInstance` 使用示例 接下来是一个简单的使用示例： ```cpp IX* pIX = NULL; HRESULT hr = ::CoCreateInstance( CLSID_Component1, NULL, CLSCTX_INPROC_SERVER, IID_IX, (void**)&pIX ); if (SUCCEEDED(hr)) { pIX->Fx(); pIX->Release(); } ``` 在这个例子中，`CLSCTX_INPROC_SERVER` 表示组件将被加载到包含进程中服务器或 DLL 中。 #### 五、类上下文 (`dwClsContext`) 解释 - **`CLSCTX_INPROC_SERVER`**：创建在同一进程中运行的组件。组件必须在 DLL 中实现。 - **`CLSCTX_INPROC_HANDLER`**：创建进程中处理器，即一个实现了某个组件部分的进程中组件，该组件的主体部分由本地或远程服务器上的某个进程外组件实现。 - **`SLSCTX_LOCAL_SERVER`**：创建一个在同一机器上的另一个进程中运行的组件。本地服务器由 EXE 实现。 - **`SLSCTX_REMOTE_SERVER`**：创建一个在远程机器上运行的组件。这需要分布式 COM 正常工作。 #### 六、执行上下文标记的预定义组合 下表列出了执行上下文标记的一些预定义组合： | 执行上下文标记 | 值 | |---|---| | `CLSCTX_INPROC` | `CLSCTX_INPROC_SERVER | CLSCTX_INPROC_HANDLER` | | `CLSCTX_ALL` | `CLSCTX_INPROC_SERVER | CLSCTX_INPROC_HANDLER | SLSCTX_LOCAL_SERVER | SLSCTX_REMOTE_SERVER` | | `CLSCTX_SERVER` | `CLSCTX_INPROC_SERVER | SLSCTX_LOCAL_SERVER | SLSCTX_REMOTE_SERVER` | 需要注意的是，`CLSCTX_REMOTE_SERVER` 的值仅在包含 OBJEBASE.H 之前定义 `_WIN32_WINNT` 的值大于或等于某个版本时才有效。 通过以上介绍，我们可以看出 `CoCreateInstance` 在 COM 编程中的重要作用及其详细的使用方法。这对于理解 COM 架构和实现组件之间的通信具有重要意义。