DXGKDDI_MIRACAST_CREATE_CONTEXT fonction de rappel (dispmprt.h)
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 vers un bloc de contexte associé à un adaptateur d’affichage. La fonction d’affichage du pilote miniport DxgkDdiAddDevice précédemment fourni ce handle 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 a 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 alloué par le pilote pour cette instance de périphérique Miracast.
[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 en tant que type D3DKMDT_VOT_MIRACAST lorsque le système d’exploitation appelle la DxgkDdiQueryChildRelations fonction pendant l’initialisation de l’appareil.
Valeur de retour
Retourne STATUS_SUCCESS si elle réussit. Sinon, elle retourne l’un des codes d’erreur définis dans Ntstatus.h, notamment :
| Retourner le code | 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 elle a besoin pour prendre en charge une session connectée Miracast.
synchronisation
Le système d’exploitation regroupe les DxgkDdiMiracastCreateContext, DxgkDdiMiracastDestroyContextet 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 de deuxième niveau. Ces fonctions peuvent être appelées lorsque d’autres fonctions de niveau 0, 1 ou d’autres classes de niveau 2 sont appelées sur un autre contexte de thread. Toutefois, une seule de ces fonctions de classe Miracast de niveau 2 peut être appelée à la fois.Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 8.1 |
| serveur minimum pris en charge | Windows Server 2012 R2 |
| plateforme cible | Bureau |
| d’en-tête | dispmprt.h (include Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |