Compartilhar 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 TRUE , exceto quando necessário, porque 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 uma variável de tipo UINT que contém o número de bytes retornados pelo driver de miniporto de exibição.

Retornar valor

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.

Comentários

Se o driver do modo de usuário miracast chamar MiracastIoControl quando o sistema operacional estiver 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 de início do Miracast seja concluída. Se o driver do modo de usuário chamar MiracastIoControl no mesmo contexto que é usado nas funções CreateMiracastContext ou StartMiracastSession , o sistema operacional processará a chamada.

Se o driver do modo de usuário miracast chamar MiracastIoControl quando o sistema operacional estiver parando 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 do modo de usuário chamar MiracastIoControl no mesmo contexto que é usado nas funções StopMiracastSession ou DestroyMiracastContext , o sistema operacional processará a chamada.

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)

Confira também

CreateMiracastContext

DestroyMiracastContext

StartMiracastSession

StopMiracastSession