DXGKDDI_MONITORDESCRIPTORSET_ACQUIREFIRSTDESCRIPTORINFO回调函数 (d3dkmddi.h)
pfnAcquireFirstDescriptorInfo 函数返回监视器描述符集对象中的第一个描述符。
语法
DXGKDDI_MONITORDESCRIPTORSET_ACQUIREFIRSTDESCRIPTORINFO DxgkddiMonitordescriptorsetAcquirefirstdescriptorinfo;
NTSTATUS DxgkddiMonitordescriptorsetAcquirefirstdescriptorinfo(
[in] IN_CONST_D3DKMDT_HMONITORDESCRIPTORSET hMonitorDescriptorSet,
[out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_DESCRIPTOR ppFirstMonitorDescriptorInfo
)
{...}
参数
[in] hMonitorDescriptorSet
监视器描述符集对象的句柄。 显示微型端口驱动程序以前通过调用 Monitor 接口的 pfnGetMonitorDescriptorSet 函数来获取此句柄。
[out] ppFirstMonitorDescriptorInfo
指向接收指向 D3DKMDT_MONITOR_DESCRIPTOR 结构的指针的变量的指针。 结构是集中的第一个描述符。
返回值
pfnAcquireFirstDescriptorInfo 函数返回以下值之一。
返回代码 | 描述 |
---|---|
STATUS_SUCCESS | 该函数已成功返回集中的第一个描述符。 |
STATUS_GRAPHICS_DATASET_IS_EMPTY | 函数成功,但集中没有描述符。 |
STATUS_INVALID_PARAMETER | 提供了无效参数。 |
STATUS_GRAPHICS_INVALID_MONITOR_DESCRIPTORSET | hMonitorDescriptorSet 中提供的句柄无效。 |
言论
使用完D3DKMDT_MONITOR_DESCRIPTOR结构后,必须通过调用 pfnReleaseDescriptorInfo释放结构。
可以通过调用 pfnAcquireFirstDescriptorInfo,然后对 pfnAcquireNextDescriptorInfo进行一系列调用来获取监视器描述符集中的所有描述符。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows Vista |
目标平台 | 桌面 |
标头 | d3dkmddi.h (包括 D3dkmddi.h) |
IRQL | PASSIVE_LEVEL |