DXGKCB_INDICATE_CHILD_STATUS回调函数 （dispmprt.h）

DxgkCbIndicateChildStatus 函数记录显示适配器的指定子设备的当前状态。

语法

DXGKCB_INDICATE_CHILD_STATUS DxgkcbIndicateChildStatus;

NTSTATUS DxgkcbIndicateChildStatus(
  [in] HANDLE DeviceHandle,
  [in] PDXGK_CHILD_STATUS ChildStatus
)
{...}

参数

[in] DeviceHandle

表示显示适配器的句柄。 显示微型端口驱动程序以前在 传递给 dxgkDdiStartDevice的 DXGKRNL_INTERFACE 结构的 DeviceHandle 成员中获取此句柄。

[in] ChildStatus

指向标识子设备的 DXGK_CHILD_STATUS 结构的指针，并描述子设备的当前状态。

返回值

DxgkCbIndicateChildStatus 如果成功，则返回STATUS_SUCCESS。 否则，它将返回 Ntstatus.h中定义的错误代码之一。

言论

当显示适配器生成中断时，显示微型端口驱动程序的 ISR 调用 DxgkCbIndicateChildStatus，原因如下：

• 外部设备（通常是监视器）已连接到显示适配器的子设备之一，该设备具有 HPD 感知价值 HpdAwarenessInterruptible。 在这种情况下，显示微型端口驱动程序将 ChildStatus->Type 设置为 StatusConnection，并设置 ChildStatus。HotPlug。连接TRUE。
• 外部设备（通常是监视器）已与具有 HPD 感知值的某个显示器适配器的子设备断开连接，该设备 HpdAwarenessInterruptible。 在这种情况下，显示微型端口驱动程序将 ChildStatus->Type 设置为 StatusConnection，并设置 ChildStatus。HotPlug。已连接FALSE。
• 连接到其板载子设备的显示设备（具有监视器方向感知值 D3DKMDT_MOA_INTERRUPTIBLE）已旋转。 在这种情况下，显示微型端口驱动程序将 ChildStatus->Type 设置为 StatusRotation，并设置 ChildStatus。旋转。角度 旋转角度。

在以下情况下，显示微型端口驱动程序的 DxgkDdiNotifyAcpiEvent 函数调用 DxgkCbIndicateChildStatus：

• 便携式计算机上的盖子打开。 在这种情况下，显示微型端口驱动程序将 ChildStatus->Type 设置为 StatusConnection，并设置 ChildStatus。HotPlug。连接TRUE。
• 便携式计算机上的盖子关闭。 在这种情况下，显示微型端口驱动程序将 ChildStatus->Type 设置为 StatusConnection，并设置 ChildStatus。HotPlug。已连接FALSE。

例子

下面的代码示例演示如何记录子设备的当前状态。

NTSTATUS
AtiSimulateMonitor(HW_DEVICE_EXTENSION *pHwDeviceExtension, PR2_SIMULATE_MONITOR i_pEscape)
{
    NTSTATUS Status;
    PVOID MonitorDescriptor = NULL;
    DXGK_CHILD_STATUS     ChildStatus;
    ChildStatus.ChildUid    =  pHwDeviceExtension->ulNumberDisplays | HW_ID_DISPLAY_CHILD;
    ChildStatus.Type    = StatusConnection;

    if(i_pEscape->Data == NULL) {
        // Remove a simulated monitor
        if(pHwDeviceExtension->pvSimulatedMonitorDescriptor != NULL) {
            ExFreePoolWithTag(pHwDeviceExtension->pvSimulatedMonitorDescriptor, ATI_TAG);
            pHwDeviceExtension->pvSimulatedMonitorDescriptor = NULL;
            pHwDeviceExtension->ulSimulatedMonitorDescriptorLength = 0;
           pHwDeviceExtension->ulRetryCount = 0;
           pHwDeviceExtension->bReportDescriptor = FALSE;

            ChildStatus.HotPlug.Connected = FALSE;
            Status = DxgkCbIndicateChildStatus(pHwDeviceExtension->DeviceHandle, &ChildStatus);
        }
        else {
            // No simulated monitor is present so the request to remove one is invalid
            return STATUS_INVALID_PARAMETER;
        }
    }
    else {
        //Add a simulated monitor
    }
    return Status;
}

要求

要求	价值
最低支持的客户端	Windows Vista
目标平台	桌面
标头	dispmprt.h （包括 Dispmprt.h）
IRQL	<=DISPATCH_LEVEL

另请参阅

DxgkDdiQueryChildRelations

DxgkDdiQueryChildStatus