通过

StiCreateInstanceW 函数 （sti.h）

  • 项目

StiCreateInstance 函数创建 COM 对象的实例，该实例定义 IStillImage 接口，并返回指向接口的指针。

语法

HRESULT StiCreateInstanceW(
  HINSTANCE    hinst,
  DWORD        dwVer,
  IStillImageW **ppSti,
  LPUNKNOWN    punkOuter
);

参数

hinst

调用方提供的调用进程的实例句柄。 此句柄是通过调用 GetModuleHandle（NULL）获取的。

dwVer

调用方提供的 STI 版本号。 此值必须STI_VERSION，Sti.h中定义。

ppSti

接收指向 IStillImage 接口的指针。

punkOuter

可选的调用方提供的指针，指向对象聚合的“控制未知”。 请参阅以下 备注 部分。

返回值

如果作成功，该方法将返回S_OK。 否则，它将返回在 stierr.h中定义的 STIERR 前缀错误代码之一。

言论

若要使应用程序使用 IStillImage 接口，它必须先调用 StiCreateInstance 函数以获取指向接口的指针。 在调用 IStillImage 方法时，随后会在 ppSti 中接收的指针，如以下示例所示：

PSTI pSti = NULL;
DWORD dwStiTotal = 0;     // total number of STI devices found
PVOID pStiInfo = NULL;    // STI device info buffer
HRESULT hres = StiCreateInstance(GetModuleHandle(NULL), STI_VERSION, &pSti, NULL);
...
hhes = pSti->GetDeviceList(0, 0, &dwStiTotal, &pStiInfo);

如果要创建包含 IStillImage的聚合 COM 对象，则必须提供指向 punkOuter中“控制未知”的指针。 在大多数情况下，不会创建聚合对象，因此 punkOuter 应 NULL。 对象聚合和控制未知内容在 聚合 一文和 组件对象模型规范中介绍。

要求

要求 价值
标头 sti.h （include Sti.h）

另请参阅

IStillImage：：release