UMDEtwLogMapAllocation 函数 (umdprovider.h)

描述如何使用 Microsoft DirectX 图形内核子系统 (Dxgkrnl.sys) 内存分配或部分分配。

语法

void UMDEtwLogMapAllocation(
  ULONGLONG                  hD3DAllocation,
  ULONGLONG                  hDxgAllocation,
  ULONGLONG                  Offset,
  ULONGLONG                  Size,
  UMDETW_ALLOCATION_USAGE    Usage,
  UMDETW_ALLOCATION_SEMANTIC Semantic
);

参数

hD3DAllocation

Direct3D 分配的句柄。

对于 Direct3D 10 用户模式驱动程序，句柄将是 CreateResource (D3D10) 函数的 hResource 参数的值。 对于 Direct3D 9 用户模式驱动程序，句柄将是驱动程序在 CreateResource 函数中返回的 pResource 参数的值。

如果驱动程序在内部使用分配，则可以将此值设置为 NULL 。

hDxgAllocation

Direct3D 分配映射到的 DirectX 图形内核子系统的句柄 (Dxgkrnl.sys) 分配。

Offset

Dxgkrnl 分配中 Direct3D 分配的起始地址（以字节为单位）。

Size

Dxgkrnl 分配中 Direct3D 分配的大小（以字节为单位）。

Usage

指示此映射原因 的UMDETW_ALLOCATION_USAGE 结构。

Semantic

如果分配由用户模式驱动程序在内部使用，则这是一个指示分配用途 的UMDETW_ALLOCATION_SEMANTIC 结构。

返回值

无

备注

用户模式显示驱动程序必须完全考虑其分配的视频内存，因此它必须调用此函数，以便在每次分配更改时记录事件。

调用此函数的示例包括：

• Direct3D 分配打包到 DirectX 图形内核子系统中， (Dxgkrnl.sys) 分配。
• Dxgkrnl 分配作为暂存图面创建。 在这种情况下，请将 hD3DAllocation 参数设置为 NULL。

UMDEtwLogMapAllocation 在 Umdprovider.h 中内联定义为：

FORCEINLINE void LogMapAllocation(BOOLEAN Enter,
                    ULONGLONG hD3DAllocation,
                    ULONGLONG hDxgAllocation,
                    ULONGLONG Offset,
                    ULONGLONG Size,
                    UMDETW_ALLOCATION_USAGE Usage,
                    UMDETW_ALLOCATION_SEMANTIC Semantic)
{
    if (Enabled)
    {   
        EVENT_DATA_DESCRIPTOR Descriptors[6];
        
        // Create a description of the event
        EventDataDescCreate(&Descriptors[0], &hD3DAllocation, 8);
        EventDataDescCreate(&Descriptors[1], &hDxgAllocation, 8);
        EventDataDescCreate(&Descriptors[2], &Offset, 8);
        EventDataDescCreate(&Descriptors[3], &Size, 8);
        EventDataDescCreate(&Descriptors[4], &Usage, 4);
        EventDataDescCreate(&Descriptors[5], &Semantic, 4);

        // Log the event
        EventWrite(
            RegHandle,
            Enter ? (InRundown ? &RundownAllocationEvent : &MapAllocationEvent) : &UnmapAllocationEvent,
            sizeof(Descriptors) / sizeof(Descriptors[0]),
            Descriptors
        );
    }
}

FORCEINLINE void UMDEtwLogMapAllocation(ULONGLONG hD3DAllocation,
                            ULONGLONG hDxgAllocation,
                            ULONGLONG Offset,
                            ULONGLONG Size,
                            UMDETW_ALLOCATION_USAGE Usage,
                            UMDETW_ALLOCATION_SEMANTIC Semantic)
{
    LogMapAllocation(TRUE,
                     hD3DAllocation,
                     hDxgAllocation,
                     Offset,
                     Size,
                     Usage,
                     Semantic);
}

要求

要求	值
最低受支持的客户端	Windows 8
最低受支持的服务器	Windows Server 2012
目标平台	桌面
标头	umdprovider.h (包括 Umdprovider.h)

另请参阅

CreateResource

CreateResource (D3D10)

UMDETW_ALLOCATION_SEMANTIC

UMDETW_ALLOCATION_USAGE