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

Cria um contexto de modo kernel para um dispositivo Miracast.

Sintaxe

DXGKDDI_MIRACAST_CREATE_CONTEXT DxgkddiMiracastCreateContext;

NTSTATUS DxgkddiMiracastCreateContext(
  [in]  PVOID DriverContext,
  [in]  DXGK_MIRACAST_DISPLAY_CALLBACKS *MiracastCallbacks,
  [out] PVOID *MiracastContext,
  [out] ULONG *TargetId
)
{...}

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] MiracastCallbacks

Um ponteiro para um buffer fornecido pelo sistema operacional que contém uma estrutura DXGK_MIRACAST_DISPLAY_CALLBACKS que tem ponteiros para funções de retorno de chamada que o driver pode chamar.

[out] MiracastContext

Um ponteiro para um buffer fornecido pelo sistema operacional que contém o endereço do contexto alocado pelo driver para essa instância do dispositivo Miracast.

[out] TargetId

Um ponteiro para um buffer fornecido pelo sistema operacional que contém a ID do destino VidPN ao qual o dispositivo Miracast está conectado. O driver deve relatar esse destino como tipo D3DKMDT_VOT_MIRACAST quando o sistema operacional chama a função DxgkDdiQueryChildRelations durante a inicialização do dispositivo.

Retornar valor

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

Código de retorno	Descrição
STATUS_RESOURCE_IN_USE	Os recursos de hardware necessários para dar suporte a uma sessão conectada do Miracast não estão disponíveis no momento.

Comentários

Quando essa função é chamada, o driver de miniporto de exibição deve preparar todos os recursos do modo kernel necessários para dar suporte a uma sessão conectada do Miracast.

Sincronização

O sistema operacional agrupa as funções DxgkDdiMiracastCreateContext, DxgkDdiMiracastDestroyContext e DxgkDdiMiracastIoControl como uma classe Miracast . O sistema operacional garante que essas funções sigam o modo de sincronização de segundo nível, conforme definido em Threading e Sincronização de Segundo Nível. Essas funções podem ser chamadas quando outras classes de nível 0, 1 ou outras de funções de nível 2 estão sendo chamadas em outro contexto de thread. No entanto, apenas uma dessas funções de classe Miracast de nível 2 pode ser chamada por vez.

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

DxgkDdiAddDevice

DxgkDdiQueryChildRelations