IDXGIAdapter：：EnumOutputs 方法 (dxgi.h)

  • 项目

枚举适配器 (视频卡) 输出。

语法

HRESULT EnumOutputs(
        UINT        Output,
  [out] IDXGIOutput **ppOutput
);

参数

Output

类型： UINT

输出的索引。

[out] ppOutput

类型： IDXGIOutput**

指向由 Output 参数指定位置的 IDXGIOutput 接口的指针的地址。

返回值

类型： HRESULT

指示成功或失败 (看到 DXGI_ERROR) 的代码。 如果索引大于输出数，则返回DXGI_ERROR_NOT_FOUND。

如果适配器来自使用 D3D_DRIVER_TYPE_WARP 创建的设备，则适配器没有输出，因此返回DXGI_ERROR_NOT_FOUND。

注解

注意 如果在会话 0 进程中调用此 API，它将返回 DXGI_ERROR_NOT_CURRENTLY_AVAILABLE。
 
当 EnumOutputs 方法成功并使用指向输出接口的指针的地址填充 ppOutput 参数时， EnumOutputs 将递增输出接口的引用计数。 为了避免内存泄漏，使用完输出接口后，请调用 Release 方法以递减引用计数。

EnumOutputs 首先返回显示桌面主服务器的输出。 此输出对应于零的索引。 然后，EnumOutputs 返回其他输出。

示例

枚举输出

下面是如何使用 EnumOutputs 枚举适配器上的所有输出的示例：


UINT i = 0;
IDXGIOutput * pOutput;
std::vector<IDXGIOutput*> vOutputs;
while(pAdapter->EnumOutputs(i, &pOutput) != DXGI_ERROR_NOT_FOUND)
{
    vOutputs.push_back(pOutput);
    ++i;
}

要求

要求 值
目标平台 Windows
标头 dxgi.h
Library DXGI.lib

另请参阅

DXGI 接口

IDXGIAdapter