UMDEtwLogUnmapAllocation 函数 （umdprovider.h）
指示不再使用 Microsoft DirectX 图形内核子系统（Dxgkrnl.sys）内存分配或部分分配。 调用此函数，无论是否正在销毁分配。
语法
void UMDEtwLogUnmapAllocation(
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
DirectX 图形内核子系统（Dxgkrnl.sys）分配的句柄，Direct3D 分配映射到该句柄。
Offset
Dxgkrnl 分配中 Direct3D 分配的起始地址（以字节为单位）。
Size
Dxgkrnl 分配中 Direct3D 分配的大小（以字节为单位）。
Usage
指示此映射原因的 UMDETW_ALLOCATION_USAGE 结构。
Semantic
如果用户模式驱动程序在内部使用分配，则这是一个 UMDETW_ALLOCATION_SEMANTIC 结构，指示分配的用途。
返回值
没有
言论
调用时，此函数会记录一个事件，该事件描述要用于分配的 API 资源，或者用于哪个 API 资源。 如果没有与分配关联的 API 资源，该函数会记录描述驱动程序为此分配指示的目的的事件。
用户模式显示驱动程序必须完全考虑它分配的视频内存，因此每次分配更改时，它都必须调用此函数来记录事件。
驱动程序应将相同的参数值传递给 UMDEtwLogUnmapAllocation，就像 UMDEtwLogMapAllocation一样。
UMDEtwLogUnmapAllocation 在 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 UMDEtwLogUnmapAllocation(ULONGLONG hD3DAllocation,
ULONGLONG hDxgAllocation,
ULONGLONG Offset,
ULONGLONG Size,
UMDETW_ALLOCATION_USAGE Usage,
UMDETW_ALLOCATION_SEMANTIC Semantic)
{
LogMapAllocation(FALSE,
hD3DAllocation,
hDxgAllocation,
Offset,
Size,
Usage,
Semantic);
}
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows 8 |
| 支持的最低服务器 | Windows Server 2012 |
| 目标平台 | 桌面 |
| 标头 | umdprovider.h（包括 Umdprovider.h） |