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

Artigo
02/23/2024

Chamado pelo sistema operacional para solicitar que o driver de miniporto de exibição processe uma solicitação de controle de E/S síncrona em resposta a uma chamada de driver de exibição no modo de usuário para a função MiracastIoControl .

Sintaxe

DXGKDDI_MIRACAST_HANDLE_IO_CONTROL DxgkddiMiracastHandleIoControl;

NTSTATUS DxgkddiMiracastHandleIoControl(
  [in]  PVOID DriverContext,
  [in]  PVOID MiracastContext,
  [in]  ULONG InputBufferSize,
  [in]  VOID *pInputBuffer,
  [in]  ULONG OutputBufferSize,
  [out] VOID *pOutputBuffer,
  [out] ULONG *BytesReturned
)
{...}

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 pelo driver de miniporto de exibição em uma chamada para a função DxgkDdiMiracastCreateContext .

[in] InputBufferSize

Fornecido pelo sistema operacional como o tamanho, em bytes, do buffer de entrada apontado por pInputBuffer. Esse valor se originou como o parâmetro InputBufferSize da função MiracastIoControl do modo de usuário.

[in] pInputBuffer

Fornecido pelo sistema operacional como um ponteiro para o buffer de entrada. Esse valor se originou como o parâmetro InputBufferSize da função MiracastIoControl do modo de usuário.

InputBufferSize especifica o tamanho do buffer.

[in] OutputBufferSize

Fornecido pelo sistema operacional como o tamanho, em bytes, do buffer de saída apontado por pOutputBuffer.

Esse valor se originou como o parâmetro OutputBufferSize da função MiracastIoControl do modo de usuário.

[out] pOutputBuffer

Fornecido pelo sistema operacional como um ponteiro para o buffer de saída. Esse valor se originou como o parâmetro pOutputBuffer da função MiracastIoControl do modo de usuário.

OutBufferSize especifica o tamanho do buffer.

[out] BytesReturned

Fornecido pelo sistema operacional como um ponteiro para um buffer que contém um valor de tipo ULONG que é o número de bytes que o driver de miniporto de exibição retornou no buffer apontado por pOutputBuffer.

Retornar valor

Retorna STATUS_SUCCESS se for bem-sucedido. Caso contrário, ele retornará um dos códigos de erro definidos em Ntstatus.h.

Comentários

O sistema operacional garante que uma chamada para DxgkDdiMiracastIoControl ocorra no mesmo espaço de processo em que a solicitação MiracastIoControl no modo de usuário é chamada.

Embora o sistema operacional simplesmente copie os valores dos tamanhos do buffer de entrada e saída dos respectivos parâmetros de MiracastIoControl, o driver de miniporto de exibição é responsável por verificar os tamanhos de buffer antes de usar os buffers. Além disso, o driver deve executar operações de investigação dentro de um bloco try/except chamando, usando as funções ProbeForRead e/ou ProbeForWrite , para verificar qualquer memória do modo de usuário para a qual os buffers de entrada apontam.

Essa operação de controle de E/S é processada de forma síncrona com uma chamada 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 nível de threading e sincronização dessa função é definido pela forma como o driver do modo de usuário define o parâmetro HardwareAccess em uma chamada para a função MiracastIoControl :

Se HardwareAccess for FALSE, o sistema operacional garantirá que DxgkDdiMiracastIoControl siga o modo de sincronização de segundo nível, conforme definido em Threading e Sincronização de Segundo Nível. DxgkDdiMiracastIoControl pode ser chamado quando outras classes de nível 0, 1 ou não Miracast de funções de nível 2 estão sendo chamadas em outro contexto de thread. No entanto, apenas uma das funções de classe Miracast de nível 2 pode ser chamada por vez.
Se HardwareAccess for TRUE, DxgkDdiMiracastIoControl seguirá o modo de sincronização de terceiro nível, conforme definido em Threading e Sincronização de Terceiro Nível. Observe que a liberação da GPU criará uma sobrecarga substancial de processamento.

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