DXGKCB_MIRACAST_SEND_MESSAGE função de retorno de chamada (dispmprt.h)
Envia uma mensagem assíncrona para o driver de exibição do modo de usuário.
Sintaxe
DXGKCB_MIRACAST_SEND_MESSAGE DxgkcbMiracastSendMessage;
NTSTATUS DxgkcbMiracastSendMessage(
[in] HANDLE MiracastHandle,
[in] ULONG InputBufferSize,
[in] VOID *pInputBuffer,
[in] ULONG OutputBufferSize,
[out] VOID *pOutputBuffer,
[in, optional] DXGKCB_MIRACAST_SEND_MESSAGE_CALLBACK pCallback,
[in, optional] PVOID pCallbackContext
)
{...}
Parâmetros
[in] MiracastHandle
Um identificador fornecido pelo driver para o dispositivo de exibição Miracast. Esse identificador foi originalmente passado no membro MiracastHandle da estrutura DXGK_MIRACAST_DISPLAY_CALLBACKS em uma chamada para a função DxgkDdiMiracastCreateContext .
[in] InputBufferSize
O tamanho, em bytes, do buffer de entrada apontado por pInputBuffer.
[in] pInputBuffer
Um ponteiro para o buffer de entrada. InputBufferSize especifica o tamanho do buffer.
Consulte Comentários para obter mais informações sobre o buffer de entrada.
[in] OutputBufferSize
O tamanho, em bytes, do buffer de saída apontado por pOutputBuffer.
[out] pOutputBuffer
Um ponteiro para o buffer de saída. OutBufferSize especifica o tamanho do buffer.
Consulte Comentários para obter mais informações sobre o buffer de saída.
[in, optional] pCallback
Um ponteiro opcional, fornecido pelo driver de miniporto de exibição, para a função de retorno de chamada DxgkCbMiracastSendMessageCallback .
Se o driver de miniporto de exibição fornecer o ponteiro para DxgkCbMiracastSendMessageCallback, depois que o driver do modo de usuário manipular a mensagem, o sistema operacional enviará uma mensagem para o driver do modo de usuário de forma assíncrona chamando DxgkCbMiracastSendMessageCallback.
Confira As seções Valor retornado e Comentários para obter mais informações sobre chamadas para DxgkCbMiracastSendMessageCallback.
[in, optional] pCallbackContext
Um ponteiro opcional fornecido pelo driver para o contexto de retorno de chamada fornecido pelo driver. O sistema operacional passa esse contexto para a rotina de retorno de chamada fornecida pelo driver após a conclusão da operação.
Retornar valor
Retorna STATUS_PENDING se ele entregar com êxito a mensagem. Caso contrário, ele retornará um dos códigos de erro definidos em Ntstatus.h.
Se o driver de miniporto de exibição precisar saber o status do tratamento de mensagens no modo de usuário, ele deverá fornecer a função DxgkCbMiracastSendMessageCallback no parâmetro pCallback e marcar o retorno status no parâmetro pIoStatusBlock dessa função.
Comentários
Se o driver de miniporto de exibição fornecer os buffers pInputBuffer e pOutputBuffer , é responsabilidade do driver manter esses dois buffers até que a função DxgkCbMiracastSendMessageCallback seja chamada. Caso contrário, um problema aleatório de corrupção de memória pode ser criado.
Se o driver fornecer o DxgkCbMiracastSendMessageCallback no parâmetro pCallback , é possível que DxgkCbMiracastSendMessageCallback retorne antes que DxgkCbMiracastSendMessage retorne.
Exemplo de sequência de chamadas
Aqui está o código de exemplo que mostra como usar essa função:typedef struct _CALLBACK_CONTEXT
{
UCHAR InputBuffer[INPUT_BUFFER_SIZE];
UCHAR OutputBuffer[OUTPUT_BUFFER_SIZE];
} CALLBACK_CONTEXT, *PCALLBACK_CONTEXT;
...
_IRQL_requires_(PASSIVE_LEVEL)
VOID
DriverCallbackFunction(
_In_ PVOID Context,
_In_ PIO_STATUS_BLOCK pIoStatusBlock
)
{
PCALLBACK_CONTEXT CallbackContex = (PCALLBACK_CONTEXT)Context;
ExFreePool(CallbackContex);
}
...
CallbackContex = (PCALLBACK_CONTEXT)ExAllocatePoolWithTag(
PagedPool,
sizeof(CALLBACK_CONTEXT),
DRIVER_TAG);
if (CallbackContex == NULL)
{
return STATUS_NO_MEMORY;
}
RtlZeroMemory(CallbackContex, sizeof(CALLBACK_CONTEXT));
CallbackContex->InputBuffer[0] = 0xaa;
CallbackContex->InputBuffer[1] = 0x55;
Status =
pDeviceContext->MiracastCallbacks.DxgkCbMiracastSendMessage(
pDeviceContext->MiracastCallbacks.MiracastHandle,
sizeof(CallbackContex->InputBuffer),
CallbackContex->InputBuffer,
sizeof(CallbackContex->OutputBuffer),
CallbackContext->OutputBuffer,
&DriverCallbackFunction,
CallbackContex);
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 |
Confira também
DXGK_MIRACAST_DISPLAY_CALLBACKS