DXGKDDI_LINK_DEVICE回调函数 (dispmprt.h)

可选的 DxgkDdiLinkDevice 函数查询显示微型端口驱动程序以获取有关链接适配器配置的信息。

语法

DXGKDDI_LINK_DEVICE DxgkddiLinkDevice;

NTSTATUS DxgkddiLinkDevice(
  [in]      IN_CONST_PDEVICE_OBJECT PhysicalDeviceObject,
  [in]      IN_CONST_PVOID MiniportDeviceContext,
  [in, out] INOUT_PLINKED_DEVICE LinkedDevice
)
{...}

参数

[in] PhysicalDeviceObject

指向物理设备对象的指针 (标识显示适配器的 PDO) 。

[in] MiniportDeviceContext

与显示适配器关联的上下文块的句柄。 显示微型端口驱动程序的 DxgkDdiAddDevice 函数之前向 Microsoft DirectX 图形内核子系统提供了此句柄。

[in, out] LinkedDevice

指向 LINKED_DEVICE 结构的指针,该结构包含有关链接的显示适配器配置的信息。

返回值

如果无法获取有关链接适配器配置的信息,DxgkDdiLinkDevice 将返回STATUS_SUCCESS或相应的错误代码。

注解

DxgkDdiLinkDevice 函数应由支持链接显示适配器的显示适配器的驱动程序实现。

如果提供此函数,操作系统将在调用 DxgkDdiAddDevice 后立即查询显示微型端口驱动程序,以获取链接的适配器配置。

如果操作系统未枚举 LinkedDevice 指向的结构中的所有预期显示适配器,则系统将在 VGA 模式下启动。

驱动程序只能枚举链接的显示适配器链中的一个前导链接。

即插即用或电源事件导致前导链接适配器在剩余链接适配器后启动或启动,或者相反,此类事件会导致前导链接适配器关闭电源或在剩余链接适配器之前禁用。

要求

要求
最低受支持的客户端 Windows Vista
目标平台 桌面
标头 dispmprt.h
IRQL PASSIVE_LEVEL

另请参阅

DxgkDdiAddDevice

LINKED_DEVICE