DXGKCB_MAP_MEMORY função de retorno de chamada (dispmprt.h)

A função DxgkCbMapMemory mapeia um intervalo de endereços físicos traduzidos (associados a um recurso de memória atribuído a um adaptador de exibição) para o espaço do sistema ou o espaço de endereço virtual de um processo de modo de usuário.

Sintaxe

DXGKCB_MAP_MEMORY DxgkcbMapMemory;

NTSTATUS DxgkcbMapMemory(
  [in]  HANDLE DeviceHandle,
  [in]  PHYSICAL_ADDRESS TranslatedAddress,
  [in]  ULONG Length,
  [in]  BOOLEAN InIoSpace,
  [in]  BOOLEAN MapToUserMode,
  [in]  MEMORY_CACHING_TYPE CacheType,
  [out] PVOID *VirtualAddress
)
{...}

Parâmetros

[in] DeviceHandle

Um identificador que representa um adaptador de exibição. O driver de miniporto de exibição obteve anteriormente esse identificador no membro DeviceHandle da estrutura DXGKRNL_INTERFACE que foi passada para DxgkDdiStartDevice.

[in] TranslatedAddress

O endereço físico traduzido base do intervalo de memória a ser mapeado. O driver de miniporto de exibição obteve esse endereço anteriormente chamando DxgkCbGetDeviceInformation.

[in] Length

O tamanho, em bytes, do intervalo a ser mapeado.

[in] InIoSpace

Um valor booliano que especifica se o intervalo está no espaço de E/S (TRUE) ou no espaço de memória (FALSE).

[in] MapToUserMode

Um valor booliano que especifica se o intervalo é mapeado para espaço no modo de usuário ou espaço do sistema. Se TRUE, o intervalo será mapeado para o espaço de endereço virtual (modo usuário) do processo atual. Se FALSE, o intervalo será mapeado para o espaço do sistema. Se InIoSpace for TRUE, esse parâmetro será ignorado.

[in] CacheType

Um enumerador MEMORY_CACHING_TYPE que especifica o comportamento de cache do intervalo mapeado.

[out] VirtualAddress

Um ponteiro para uma variável que recebe o endereço do início do intervalo mapeado. A maneira como o intervalo mapeado é acessado depende dos valores de InIoSpace e MapToUserMode. A tabela a seguir resume as diferentes maneiras pelas quais o intervalo mapeado é acessado.

Retornar valor

DxgkCbMapMemory retornará STATUS_SUCCESS se for bem-sucedido. Caso contrário, ele retornará um dos códigos de erro definidos em Ntstatus.h.

Comentários

O tipo de dados PHYSICAL_ADDRESS é definido em Ntdef.h.

Requisitos

Confira também

MEMORY_CACHING_TYPE