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 |