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

Artigo
08/07/2023

Destrói uma instância de um dispositivo Miracast.

Sintaxe

DXGKDDI_MIRACAST_DESTROY_CONTEXT DxgkddiMiracastDestroyContext;

void DxgkddiMiracastDestroyContext(
  [in] PVOID DriverContext,
  [in] PVOID MiracastContext
)
{...}

Parâmetros

[in] DriverContext

Um identificador para um bloco de contexto associado a um adaptador de exibição. A função DxgkDdiAddDevice do driver de miniporta de exibição forneceu anteriormente esse identificador para o subsistema de kernel de elementos gráficos DirectX.

[in] MiracastContext

O contexto do dispositivo Miracast, fornecido pelo sistema operacional. Esse contexto foi fornecido anteriormente pelo driver em uma chamada para a função DxgkDdiMiracastCreateContext .

Retornar valor

Nenhum

Comentários

Quando essa função é chamada, o driver de miniporto de exibição deve liberar todos os recursos do modo kernel alocados quando processou a função DxgkDdiMiracastCreateContext e deve enviar imediatamente um valor de reconhecimento de hpd (detecção de plug-quente) de saída do monitor para o sistema operacional.

O sistema operacional garante que, depois de chamar essa função, ele não fará mais chamadas para a função DxgkDdiMiracastIoControl .

Se um dispositivo Miracast for desconectado antes da conclusão da função DxgkDdiCommitVidPn , enquanto uma operação atual ainda estiver ocorrendo neste destino miracast, o driver de miniporto de exibição não deverá enviar nenhum dado para o driver Miracast no modo de usuário.

Se a função StopMiracastSession no modo de usuário demorar muito para ser concluída, o sistema operacional chamará DxgkDdiMiracastDestroyContext enquanto o driver Miracast no modo de usuário ainda estiver em execução. Nesse caso, o sistema operacional bloqueia as chamadas adicionais para a função MiracastIoControl no modo de usuário.

Sincronização

O sistema operacional agrupa as funções DxgkDdiMiracastCreateContext, DxgkDdiMiracastDestroyContext e DxgkDdiMiracastIoControl como uma classe Miracast . O sistema operacional garante que essas funções sigam o modo de sincronização de segundo nível, conforme definido em Threading e Sincronização de Segundo Nível. Essas funções podem ser chamadas quando outras classes de nível 0, 1 ou outras de funções de nível 2 estão sendo chamadas em outro contexto de thread. No entanto, apenas uma dessas funções de classe Miracast de nível 2 pode ser chamada por vez.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8.1
Servidor mínimo com suporte	Windows Server 2012 R2
Plataforma de Destino	Área de Trabalho
Cabeçalho	dispmprt.h (inclua Dispmprt.h)
IRQL	PASSIVE_LEVEL