PFN_HANDLE_KMD_MESSAGE função de retorno de chamada (netdispumdddi.h)

Artigo
08/07/2023

Chamado pelo sistema operacional para lidar com a mensagem assíncrona do modo kernel que o driver do modo de usuário miracast recebe quando o driver de miniporto de exibição chama a função DxgkCbMiracastSendMessage .

Sintaxe

PFN_HANDLE_KMD_MESSAGE PfnHandleKmdMessage;

NTSTATUS PfnHandleKmdMessage(
  [in]  PVOID pMiracastContext,
  [in]  UINT InputBufferSize,
  [in]  VOID *pInputBuffer,
  [in]  UINT OutputBufferSize,
  [out] VOID *pOutputBuffer,
  [out] UINT *pBytesReturned
)
{...}

Parâmetros

[in] pMiracastContext

Um ponteiro para um contexto associado a um adaptador de exibição.

O sistema operacional obteve o contexto quando chamou a função CreateMiracastContext do driver de modo de usuário do Miracast.

[in] InputBufferSize

O tamanho do buffer de entrada pInputBuffer, fornecido pelo sistema operacional.

[in] pInputBuffer

Um ponteiro para o buffer de entrada, fornecido pelo sistema operacional.

[in] OutputBufferSize

O tamanho do buffer de saída pOutputBuffer, fornecido pelo sistema operacional.

[out] pOutputBuffer

Um ponteiro para o buffer de saída, fornecido pelo sistema operacional.

[out] pBytesReturned

Um ponteiro para um buffer, fornecido pelo sistema operacional, que contém o número de bytes retornados que o driver de miniporto de exibição escreveu em pOutputBuffer.

Retornar valor

Com êxito, essa função retorna STATUS_SUCCESS. Caso contrário, a função retornará um código de erro definido no cabeçalho Ntstatus.h.

Comentários

Acesso thread-safe

Quando essa função é chamada, é possível que ela também tenha sido chamada em outro thread. Portanto, o driver é responsável por sincronizar várias chamadas para HandleKernelModeMessage , se necessário.

O sistema operacional garante que essa função não seja chamada quando CreateMiracastContext, DestroyMiracastContext, StartMiracastSession e StopMiracastSession forem chamados. Todas as mensagens que o driver de miniporto de exibição envia durante a inicialização de uma sessão conectada miracast (StartMiracastSession) são bloqueadas até que o processo de inicialização da sessão seja concluído. O sistema operacional também bloqueia todas as mensagens que o driver de miniporto de exibição envia durante ou após uma chamada para interromper a sessão miracast (StopMiracastSession).

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	netdispumdddi.h (inclua Netdispumdddi.h)