Função UMDEtwLogMapAllocation (umdprovider.h)

Artigo
02/07/2025

Descreve como uma alocação de memória de subsistema de kernel de elementos gráficos do Microsoft DirectX (Dxgkrnl.sys) ou uma parte da alocação está sendo usada.

Sintaxe

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

Parâmetros

hD3DAllocation

Um identificador para a alocação do Direct3D.

Para drivers de modo de usuário do Direct3D 10, o identificador será o valor do parâmetro hResource da função CreateResource(D3D10). Para drivers de modo de usuário do Direct3D 9, o identificador será o valor do parâmetro pResource que o driver retorna na função CreateResource.

O driver pode definir esse valor para NULL se ele usar alocações internamente.

hDxgAllocation

Um identificador para a alocação do subsistema de kernel de elementos gráficos DirectX (Dxgkrnl.sys) para a qual a alocação do Direct3D é mapeada.

Offset

O endereço inicial, em bytes, da alocação Direct3D dentro da alocação Dxgkrnl.

Size

O tamanho, em bytes, da alocação Direct3D dentro da alocação Dxgkrnl.

Usage

Uma estrutura UMDETW_ALLOCATION_USAGE que indica o motivo desse mapeamento.

Semantic

Se a alocação for usada internamente pelo driver de modo de usuário, essa será uma estrutura UMDETW_ALLOCATION_SEMANTIC que indica para que a alocação é usada.

Valor de retorno

Nenhum

Observações

O driver de exibição do modo de usuário deve considerar completamente a memória de vídeo alocada, portanto, ele deve chamar essa função para registrar um evento sempre que a alocação for alterada.

Exemplos de quando chamar essa função são:

Uma alocação direct3D é empacotada em uma alocação de subsistema de kernel de elementos gráficos DirectX (Dxgkrnl.sys).
Uma alocação Dxgkrnl é criada como uma superfície de zero. Nesse caso, defina o parâmetro hD3DAllocation para NULL.

UMDEtwLogMapAllocation é definido embutido em Umdprovider.h como:

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);
}

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 8
servidor com suporte mínimo	Windows Server 2012
da Plataforma de Destino	Área de trabalho
cabeçalho	umdprovider.h (include Umdprovider.h)

Consulte também

CreateResource

CreateResource(D3D10)

UMDETW_ALLOCATION_SEMANTIC

UMDETW_ALLOCATION_USAGE

Partilhar via