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