Partilhar via


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 miniporto de exibição anteriormente forneceu 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 que o driver alocou 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.

Valor de retorno

Retorna STATUS_SUCCESS se tiver êxito. 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.

Observações

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 de

O sistema operacional agrupa as funções DxgkDdiMiracastCreateContext, DxgkDdiMiracastDestroyContexte DxgkDdiMiracastIoControl como uma classe de miracast. O sistema operacional garante que essas funções sigam o modo de sincronização de segundo nível, conforme definido em de Segundo Nível de Threading e Sincronização. 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
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 dispmprt.h (inclua Dispmprt.h)
IRQL PASSIVE_LEVEL

Consulte também

DXGK_MIRACAST_DISPLAY_CALLBACKS

DxgkDdiAddDevice

DxgkDdiQueryChildRelations