Partilhar via


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

Chamado pelo driver de exibição do modo de usuário para enviar ao driver de miniporto de exibição do modo kernel uma solicitação de controle de E/S síncrona. O tipo de dados dessa função é PFN_MIRACAST_IO_CONTROL.

Sintaxe

PFN_MIRACAST_IO_CONTROL PfnMiracastIoControl;

NTSTATUS PfnMiracastIoControl(
  [in]            HANDLE hMiracastDeviceHandle,
  [in]            BOOL HardwareAccess,
  [in]            UINT InputBufferSize,
  [in]            VOID *pInputBuffer,
  [in]            UINT OutputBufferSize,
  [out]           VOID *pOutputBuffer,
  [out, optional] UINT *pBytesReturned
)
{...}

Parâmetros

[in] hMiracastDeviceHandle

Um identificador que representa um dispositivo Miracast. O driver do modo de usuário miracast obteve anteriormente esse identificador como o parâmetro hMiracastDeviceHandle em uma chamada para a função CreateMiracastContext.

[in] HardwareAccess

Um valor booliano que indica se essa solicitação de controle de E/S do driver de exibição do modo de usuário precisa liberar todos os buffers de DMA de GPU pendentes.

Não recomendamos que o driver defina esse valor como VERDADEIRO exceto quando necessário, pois a liberação da GPU criará uma sobrecarga de processamento substancial.

[in] InputBufferSize

O tamanho, em bytes, do buffer de entrada apontado por pInputBuffer.

[in] pInputBuffer

Um ponteiro para o buffer de entrada. O parâmetro InputBufferSize especifica o tamanho do buffer.

[in] OutputBufferSize

O tamanho, em bytes, do buffer de saída apontado por pOutputBuffer.

[out] pOutputBuffer

Um ponteiro fornecido pelo driver para o buffer de saída. O parâmetro OutputBufferSize especifica o tamanho do buffer.

[out, optional] pBytesReturned

Um ponteiro opcional fornecido pelo driver para um variável UINTtipo que contém o número de bytes retornados pelo driver de miniporto de exibição.

Valor de retorno

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

Observações

Se o driver do modo de usuário miracast chamar MiracastIoControl quando o sistema operacional está iniciando uma sessão miracast, e se o thread de chamada não for o thread no qual o sistema operacional chama a função StartMiracastSession, o sistema operacional bloqueará a chamada MiracastIoControl até que a sessão inicial do Miracast seja concluída. Se o driver do modo de usuário chamar MiracastIoControl no mesmo contexto que é usado no CreateMiracastContext ou funções de StartMiracastSession, o sistema operacional processará a chamada.

Se o driver do modo de usuário miracast chamar MiracastIoControl quando o sistema operacional estiver interrompendo uma sessão miracast e se o thread de chamada não for o thread no qual o sistema operacional chama a função StopMiracastSession, o sistema operacional falhará nessa chamada. Se o driver de modo de usuário chamar MiracastIoControl no mesmo contexto que é usado no StopMiracastSession ou funções DestroyMiracastContext, o sistema operacional processará a chamada.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 8.1
servidor com suporte mínimo Windows Server 2012 R2
da Plataforma de Destino Área de trabalho
cabeçalho netdispumdddi.h (include Netdispumdddi.h)

Consulte também

CreateMiracastContext

DestroyMiracastContext

StartMiracastSession

StopMiracastSession