DXGKDDI_MIRACAST_CREATE_CONTEXT fonction de rappel (dispmprt.h)

Article
02/23/2024

Crée un contexte en mode noyau pour un appareil Miracast.

Syntaxe

DXGKDDI_MIRACAST_CREATE_CONTEXT DxgkddiMiracastCreateContext;

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

Paramètres

[in] DriverContext

Handle d’un bloc de contexte associé à une carte d’affichage. La fonction DxgkDdiAddDevice du pilote miniport d’affichage fournissait précédemment cette poignée au sous-système du noyau graphique DirectX.

[in] MiracastCallbacks

Pointeur vers une mémoire tampon fournie par le système d’exploitation qui contient une structure DXGK_MIRACAST_DISPLAY_CALLBACKS qui contient des pointeurs vers des fonctions de rappel que le pilote peut appeler.

[out] MiracastContext

Pointeur vers une mémoire tampon fournie par le système d’exploitation qui contient l’adresse du contexte que le pilote alloué pour ce périphérique Miracast instance.

[out] TargetId

Pointeur vers une mémoire tampon fournie par le système d’exploitation qui contient l’ID de la cible VidPN à laquelle l’appareil Miracast est connecté. Le pilote doit signaler cette cible comme type D3DKMDT_VOT_MIRACAST lorsque le système d’exploitation appelle la fonction DxgkDdiQueryChildRelations lors de l’initialisation de l’appareil.

Valeur retournée

Retourne STATUS_SUCCESS si elle réussit. Sinon, il retourne l’un des codes d’erreur définis dans Ntstatus.h, notamment :

Code de retour	Description
STATUS_RESOURCE_IN_USE	Les ressources matérielles nécessaires pour prendre en charge une session connectée Miracast ne sont pas actuellement disponibles.

Remarques

Lorsque cette fonction est appelée, le pilote miniport d’affichage doit préparer toutes les ressources en mode noyau dont il a besoin pour prendre en charge une session connectée Miracast.

Synchronisation

Le système d’exploitation regroupe DxgkDdiMiracastCreateContext, DxgkDdiMiracastDestroyContext et DxgkDdiMiracastIoControl fonctionne comme une classe Miracast . Le système d’exploitation garantit que ces fonctions suivent le mode de synchronisation de deuxième niveau tel que défini dans Threading et Synchronisation deuxième niveau. Ces fonctions peuvent être appelées lorsque d’autres niveaux 0, 1 ou d’autres classes de fonctions de niveau 2 sont appelées dans un autre contexte de thread. Toutefois, une seule de ces fonctions de classe Miracast de niveau 2 peut être appelée à la fois.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8.1
Serveur minimal pris en charge	Windows Server 2012 R2
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	dispmprt.h (inclure Dispmprt.h)
IRQL	PASSIVE_LEVEL

Voir aussi

DXGK_MIRACAST_DISPLAY_CALLBACKS

DxgkDdiAddDevice

DxgkDdiQueryChildRelations

Partager via