已屏蔽 原因:{{ notice.reason }}已屏蔽
{{notice.noticeContent}}
~~空空如也
二、我们的第一个COM程序

1. COM环境的建立

首先用Visual Studio建立一个普通的控制台程序(去掉预编译头)。在前面添加windows.h的包含文件:
#include <windows.h>

使用COM之前首先要初始化COM环境——初始化COM环境使用CoInitialize(0)函数。它唯一的参数是保留的,必须始终为0:
HRESULT hr = CoInitialize(0);
ValidateHR(hr);
其中ValidateHR(hr)宏在上一节已经定义过了,用于检验COM调用是否成功,若失败则报错并退出程序。

在程序结束之前,要调用CoUninitialize()卸载COM环境,这个函数很简单,没有参数,没有返回值,直接调用即可:
CoUninitialize();

至此,我们的程序如下,这便是最简单的COM程序了:
<code class="lang-cpp">#include <stdio.h>
#include <stdlib.h>
                                     
#include <windows.h> // 使用COM组件需要包含windows.h
                                     
#define ValidateHR(hr) \
    if (FAILED(hr)) { \
        printf("HRESULT错误:%p,在%s第%d行\n", hr, __FILE__, __LINE__); \
        exit(1); \
    }
                                     
int main()
{
    HRESULT hr = CoInitialize(0); // 初始化COM环境,参数保留,必须为0
    ValidateHR(hr);
                                     
    // 什么也不做
                                     
    CoUninitialize(); // 卸载COM环境
    return 0;
}</windows.h></stdlib.h></stdio.h></code>

2. 接口实例的获取、使用与释放

不同于大多数C++对象,COM组件是使用引用计数管理生命周期的。每一个接口实例都对应着组件的一个引用计数。每获得一个新的接口实例,组件的引用计数加一。每释放一个旧的接口实例,组件的引用计数减一。当引用计数减为0时,COM组件将析构并释放自己的内存。

获取一个COM接口实例有CoCreateInstanceQueryInterfaceAddRef等很多种方法,而释放一个COM接口实例一般是调用Release

a.释放一个接口实例

释放一个接口实例比较简单,但是正确地释放接口实例却非常重要。如果不正确释放,就会导致内存泄漏或者程序崩溃。上面已经讲了,每一个接口都有IUnknown的三个函数:QueryInterface、AddRef、Release。在使用完一个实例之后,程序要调用此接口的Release成员函数释放该实例。Release会使得引用计数减一,并于引用计数归零时删除组件本身每一个实例都需要调用一次Release:
p1->Release(); // p1 是程序所拥有的一个COM接口实例

b.获取一个接口实例


获取接口实例最通用的的方法,是使用CoCreateInstance函数。由于CoCreateInstance建立了新的接口实例,因此CoCreateInstance调用后,它会使组件的引用计数加一

CoCreateInstance函数的使用方法如下:
HRESULT hr = CoCreateInstance(CLSID_组件ID, NULL, CLSCTX_ALL, IID_接口ID, (void**)&接口指针);
第一个参数是组件ID(CLSID),第四个参数是接口ID(IID),可以在相关头文件中找到它的常量定义。最后一个参数是返回值,用以接收CoCreateInstance返回的接口指针。
第二个参数(外层IUnknown指针)不常用,一般指定为NULL。第三个参数(组件环境)一般指定CLSCTX_ALL,表示可以接受任何形式的COM服务(进程内、进程外、远程都可以)。

获取相同组件相同接口的新实例的方法,是使用AddRef它也会使得组件的引用计数加一AddRef的用法如下:
IMyInterface *p2 = p1; // p2和p1指向相同的实例
p2->AddRef(); // 在p2建立IMyInterface新的实例,引用计数加一

获取相同组件任意接口的新实例的方法,是使用QueryInterface它同样会使组件的引用计数加一
HRESULT hr = p1->QueryInterface(IID_接口ID, (void**)&接口指针);
QueryInterface的两个参数和CoCreateInstance最后两个参数的含义相同。

3. 获取、使用和释放接口实例的实际操作

在这里我们将要调用的是Windows的文字转语音(Text-To-Speech)引擎,需要包含头文件#include <sapi.h>
<code class="lang-cpp">#include <sapi.h></sapi.h></code>

在sapi.h中,文字转语音使用的接口是ISpVoice,其组件ID为CLSID_SpVoice,接口ID为IID_ISpVoice。ISpVoice的成员函数Speak可以让电脑开始说话。首先,我们要建立一个ISpVoice实例:
<code class="lang-cpp">// 建立ISpVoice接口实例(组件ID为CLSID_SpVoice,接口ID为IID_ISpVoice)
ISpVoice *iSpVoice = NULL;
hr = CoCreateInstance(CLSID_SpVoice, NULL, CLSCTX_ALL, IID_ISpVoice, (void**)&iSpVoice);
ValidateHR(hr);</code>

ISpVoice实例建立成功之后,我们就可以使用->操作符直接调用它的的Speak函数了:
<code class="lang-cpp">// 调用ISpVoice的Speak成员函数
iSpVoice->Speak(L"电脑在说话!", SPF_DEFAULT, NULL);
ValidateHR(hr);</code>

最后,别忘了释放ISpVoice的实例!
<code class="lang-cpp">// 释放ISpVoice接口实例
iSpVoice->Release();</code>

最后的程序如下。把音量开到最大,按Ctrl+F5运行,即可听到电脑在说话![s::lol]
<code class="lang-cpp">#include <stdio.h>
#include <stdlib.h>
                                    
#include <windows.h> // 使用COM组件需要包含windows.h
#include <sapi.h> // 使用ISpVoice语音组件需要包含sapi.h
                                    
#define ValidateHR(hr) \
    if (FAILED(hr)) { \
        printf("HRESULT错误:%p,在%s第%d行\n", hr, __FILE__, __LINE__); \
        exit(1); \
    }
                                    
int main()
{
    HRESULT hr = CoInitialize(0); // 初始化COM环境,参数保留,必须为0
    ValidateHR(hr);
                                    
    // 建立ISpVoice接口实例(组件ID为CLSID_SpVoice,接口ID为IID_ISpVoice)
    ISpVoice *iSpVoice = NULL;
    hr = CoCreateInstance(CLSID_SpVoice, NULL, CLSCTX_ALL, IID_ISpVoice, (void**)&iSpVoice);
    ValidateHR(hr);
                                    
    // 调用ISpVoice的Speak成员函数
    hr = iSpVoice->Speak(L"电脑在说话!", SPF_DEFAULT, NULL);
    ValidateHR(hr);
                                    
    // 释放ISpVoice接口实例
    iSpVoice->Release();
                                    
    CoUninitialize(); // 卸载COM环境
    return 0;
}</sapi.h></windows.h></stdlib.h></stdio.h></code>
文号 / 789533

千古风流
名片发私信
学术分 4
总主题 466 帖总回复 2942 楼拥有证书:进士 学者 笔友
注册于 2009-05-30 21:22最后登录 2019-01-31 17:16
主体类型:个人
所属领域:无
认证方式:邮箱
IP归属地:未同步

个人简介

暂未填写
文件下载
加载中...
{{errorInfo}}
{{downloadWarning}}
你在 {{downloadTime}} 下载过当前文件。
文件名称:{{resource.defaultFile.name}}
下载次数:{{resource.hits}}
上传用户:{{uploader.username}}
所需积分:{{costScores}},{{holdScores}}下载当前附件免费{{description}}
积分不足,去充值
文件已丢失

当前账号的附件下载数量限制如下:
时段 个数
{{f.startingTime}}点 - {{f.endTime}}点 {{f.fileCount}}
视频暂不能访问,请登录试试
仅供内部学术交流或培训使用,请先保存到本地。本内容不代表科创观点,未经原作者同意,请勿转载。
音频暂不能访问,请登录试试
投诉或举报
加载中...
{{tip}}
请选择违规类型:
{{reason.type}}

空空如也

插入资源
全部
图片
视频
音频
附件
全部
未使用
已使用
正在上传
空空如也~
上传中..{{f.progress}}%
处理中..
上传失败,点击重试
等待中...
{{f.name}}
空空如也~
(视频){{r.oname}}
{{selectedResourcesId.indexOf(r.rid) + 1}}
处理中..
处理失败
插入表情
我的表情
共享表情
Emoji
上传
注意事项
最大尺寸100px,超过会被压缩。为保证效果,建议上传前自行处理。
建议上传自己DIY的表情,严禁上传侵权内容。
点击重试等待上传{{s.progress}}%处理中...已上传,正在处理中
空空如也~
处理中...
处理失败
加载中...
草稿箱
加载中...
此处只插入正文,如果要使用草稿中的其余内容,请点击继续创作。
{{fromNow(d.toc)}}
{{getDraftInfo(d)}}
标题:{{d.t}}
内容:{{d.c}}
继续创作
删除插入插入
插入公式
评论控制
加载中...
文号:{{pid}}
加载中...
详情
详情
推送到专栏从专栏移除
设为匿名取消匿名
查看作者
回复
只看作者
加入收藏取消收藏
收藏
取消收藏
折叠回复
置顶取消置顶
评学术分
鼓励
设为精选取消精选
管理提醒
编辑
通过审核
评论控制
退修或删除
历史版本
违规记录
投诉或举报
加入黑名单移除黑名单
查看IP
{{format('YYYY/MM/DD HH:mm:ss', toc)}}
ID: {{user.uid}}