DXGKDDI_SETDISPLAYPRIVATEDRIVERFORMAT função de retorno de chamada (d3dkmddi.h)

Artigo
02/06/2025

A função DxgkDdiSetDisplayPrivateDriverFormat altera o atributo de formato privado de uma fonte de vídeo presente.

Sintaxe

DXGKDDI_SETDISPLAYPRIVATEDRIVERFORMAT DxgkddiSetdisplayprivatedriverformat;

NTSTATUS DxgkddiSetdisplayprivatedriverformat(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_SETDISPLAYPRIVATEDRIVERFORMAT pSetDisplayPrivateDriverFormat
)
{...}

Parâmetros

[in] hAdapter

Um identificador para um bloco de contexto associado a um adaptador de exibição. O driver de miniporto de exibição forneceu anteriormente esse identificador para o subsistema de kernel de elementos gráficos do Microsoft DirectX na função MiniportDeviceContext da função DxgkDdiAddDevice.

[in] pSetDisplayPrivateDriverFormat

Um ponteiro para uma estrutura DXGKARG_SETDISPLAYPRIVATEDRIVERFORMAT que contém argumentos de função.

Valor de retorno

DxgkDdiSetDisplayPrivateDriverFormat retornará STATUS_SUCCESS se tiver êxito; caso contrário, ele retorna STATUS_UNSUCCESSFUL para indicar que o driver não pôde alterar o atributo de formato privado da fonte presente do vídeo fornecida.

Observações

O subsistema de kernel de elementos gráficos DirectX chama a função DxgkDdiSetDisplayPrivateDriverFormat do driver de exibição de exibição após o driver de exibição do modo de usuário chamar a função de retorno de chamada pfnSetDisplayPrivateDriverFormatCb. Por exemplo, o driver de exibição do modo de usuário pode chamar pfnSetDisplayPrivateDriverFormatCb para alterar o formato giratório da fonte presente do vídeo quando uma alteração de inversão de tela inteira é criada. Em seguida, o subsistema de kernel de elementos gráficos DirectX chama o DxgkDdiSetDisplayPrivateDriverFormat para alterar o formato de driver privado da fonte presente do vídeo. Isso permite que a alocação primária seja exibida na fonte presente do vídeo sem a necessidade de tradução da superfície primária.

ObservaçãoDxgkDdiSetDisplayPrivateDriverFormat não aplica o formato de driver privado que o PrivateDriverFormatAttribute membro da estrutura DXGKARG_SETDISPLAYPRIVATEDRIVERFORMAT que é apontado por pSetDisplayPrivateDriverFormat especifica a qualquer alocação. DxgkDdiSetDisplayPrivateDriverFormat aplica o formato de driver privado diretamente à fonte presente do vídeo. Por exemplo, DxgkDdiSetDisplayPrivateDriverFormat pode reprogramar os registros da DAC para verificar de um formato diferente.

DxgkDdiSetDisplayPrivateDriverFormat deve ficar paginável.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista
da Plataforma de Destino	Área de trabalho
cabeçalho	d3dkmddi.h
IRQL	PASSIVE_LEVEL

Consulte também

DXGKARG_SETDISPLAYPRIVATEDRIVERFORMAT

pfnSetDisplayPrivateDriverFormatCb

Compartilhar via