SwapChainPanel.CreateCoreIndependentInputSource Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
CreateCoreIndependentInputSource(InputPointerSourceDeviceKinds) |
Crée un objet d’entrée principal qui gère les types d’entrée comme spécifié par le paramètre deviceKinds . Cet objet d’entrée de base peut traiter les événements d’entrée sur un thread d’arrière-plan. |
CreateCoreIndependentInputSource(CoreInputDeviceTypes) |
Crée un objet d’entrée principal qui gère les types d’entrée comme spécifié par le paramètre deviceTypes . Cet objet d’entrée de base peut traiter les événements d’entrée sur un thread d’arrière-plan. |
CreateCoreIndependentInputSource(InputPointerSourceDeviceKinds)
Crée un objet d’entrée principal qui gère les types d’entrée comme spécifié par le paramètre deviceKinds . Cet objet d’entrée de base peut traiter les événements d’entrée sur un thread d’arrière-plan.
public:
virtual InputPointerSource ^ CreateCoreIndependentInputSource(InputPointerSourceDeviceKinds deviceKinds) = CreateCoreIndependentInputSource;
InputPointerSource CreateCoreIndependentInputSource(InputPointerSourceDeviceKinds const& deviceKinds);
public InputPointerSource CreateCoreIndependentInputSource(InputPointerSourceDeviceKinds deviceKinds);
function createCoreIndependentInputSource(deviceKinds)
Public Function CreateCoreIndependentInputSource (deviceKinds As InputPointerSourceDeviceKinds) As InputPointerSource
Paramètres
- deviceKinds
- InputPointerSourceDeviceKinds
Valeur combinée de l’énumération.
Retours
Objet qui représente le sous-système d’entrée à des fins d’interopérabilité et qui peut être utilisé pour les points de connexion d’événement d’entrée.
Remarques
Cette méthode permet à une application qui inclut un SwapChainPanel de gérer l’entrée et le rendu indépendamment du thread d’interface utilisateur XAML, car vous fournissez délibérément la logique de traitement d’entrée sur un thread d’arrière-plan. Vous devez appeler CreateCoreIndependentInputSource à partir d’un thread autre que l’interface utilisateur, sinon cette méthode échoue.
Utilisez cette méthode pour créer un objet d’entrée principal et l’associer à votre SwapChainPanel. Une fois la création réussie, l’entrée utilisateur des types d’appareils spécifiés qui accèdent au contenu SwapChainPanel est redirigée vers le thread à partir duquel CreateCoreIndependentInputSource a été appelé. Votre application peut gérer cette entrée en s’inscrivant pour les événements d’entrée et en traitant ces événements sur un thread d’arrière-plan. Pour recevoir des messages d’entrée via l’objet CoreIndependentInputSource , le code de l’application doit définir une chaîne d’échange sur swapChainPanel et effectuer le rendu (au niveau de Microsoft DirectX) à partir de cette chaîne d’échange au moins une fois. Cela fournit le rendu qui rend possible le test d’accès.
Vous utilisez généralement CoreDispatcher.ProcessEvents dans le cadre de la gestion des événements. Obtenez une référence CoreDispatcher à partir de CoreIndependentInputSource.Dispatcher. Pour plus d’informations sur l’utilisation des threads d’arrière-plan, consultez ThreadPool ou Threading et programmation asynchrone.
Vous pouvez appeler cette méthode plusieurs fois. Chaque fois que CreateCoreIndependentInputSource est appelé, l’objet CoreIndependentInputSource précédent est dissocié de l’objet SwapChainPanel. En d’autres termes, un seul objet CoreIndependentInputSource peut obtenir des événements à la fois.
Pour obtenir un exemple de code montrant comment utiliser CreateCoreIndependentInputSource, consultez la DrawingPanel
définition de classe qui fait partie de l’exemple d’interopérabilité DirectX XAML SwapChainPanel.
CreateCoreIndependentInputSource peut retourner la valeur Null si deviceKinds a été passé en tant que InputPointerSourceDeviceKinds.None (ce n’est pas un moyen classique d’appeler CreateCoreIndependentInputSource).
Voir aussi
- ThreadPool
- Threads et programmation asynchrone
- Technologie interop DirectX et XAML
- Exemple d’interopérabilité XAML SwapChainPanel DirectX
- Exemple d’entrée à faible latence
S’applique à
CreateCoreIndependentInputSource(CoreInputDeviceTypes)
Crée un objet d’entrée principal qui gère les types d’entrée comme spécifié par le paramètre deviceTypes . Cet objet d’entrée de base peut traiter les événements d’entrée sur un thread d’arrière-plan.
public:
virtual ExpIndependentPointerInputObserver ^ CreateCoreIndependentInputSource(CoreInputDeviceTypes deviceTypes) = CreateCoreIndependentInputSource;
ExpIndependentPointerInputObserver CreateCoreIndependentInputSource(CoreInputDeviceTypes const& deviceTypes);
public ExpIndependentPointerInputObserver CreateCoreIndependentInputSource(CoreInputDeviceTypes deviceTypes);
function createCoreIndependentInputSource(deviceTypes)
Public Function CreateCoreIndependentInputSource (deviceTypes As CoreInputDeviceTypes) As ExpIndependentPointerInputObserver
Paramètres
- deviceTypes
- CoreInputDeviceTypes
Valeur combinée de l’énumération.
Retours
Objet qui représente le sous-système d’entrée à des fins d’interopérabilité et peut être utilisé pour les points de connexion d’événement d’entrée.
Remarques
Cette méthode permet à une application qui inclut un SwapChainPanel de gérer l’entrée et le rendu indépendamment du thread d’interface utilisateur XAML, car vous fournissez délibérément la logique de traitement d’entrée sur un thread d’arrière-plan. Vous devez appeler CreateCoreIndependentInputSource à partir d’un thread autre que l’interface utilisateur, sinon cette méthode échoue.
Utilisez cette méthode pour créer un objet d’entrée principal et l’associer à votre SwapChainPanel. Une fois la création réussie, l’entrée utilisateur des types d’appareils spécifiés qui accèdent au contenu SwapChainPanel est redirigée vers le thread à partir duquel CreateCoreIndependentInputSource a été appelé. Votre application peut gérer cette entrée en s’inscrivant pour les événements d’entrée et en traitant ces événements sur un thread d’arrière-plan. Pour recevoir des messages d’entrée via l’objet CoreIndependentInputSource , le code de l’application doit définir une chaîne d’échange sur swapChainPanel et effectuer le rendu (au niveau de Microsoft DirectX) à partir de cette chaîne d’échange au moins une fois. Cela fournit le rendu qui rend possible le test d’accès.
Vous utilisez généralement CoreDispatcher.ProcessEvents dans le cadre de la gestion des événements. Obtenez une référence CoreDispatcher à partir de CoreIndependentInputSource.Dispatcher. Pour plus d’informations sur l’utilisation des threads d’arrière-plan, consultez ThreadPool ou Threading et programmation asynchrone.
Vous pouvez appeler CreateCoreIndependentInputSource plusieurs fois. Chaque fois que CreateCoreIndependentInputSource est appelé, l’objet CoreIndependentInputSource précédent est dissocié de l’objet SwapChainPanel. En d’autres termes, un seul objet CoreIndependentInputSource peut obtenir des événements à la fois.
Pour obtenir un exemple de code montrant comment utiliser CreateCoreIndependentInputSource, consultez la DrawingPanel
définition de classe qui fait partie de l’exemple d’interopérabilité DirectX XAML SwapChainPanel.
CreateCoreIndependentInputSource peut retourner null si deviceTypes a été passé en tant que CoreInputDeviceTypes.None (ce n’est pas un moyen classique d’appeler CreateCoreIndependentInputSource).
Voir aussi
- CoreIndependentInputSource
- ThreadPool
- Threads et programmation asynchrone
- Technologie interop DirectX et XAML
- Exemple d’interopérabilité XAML SwapChainPanel DirectX
- Exemple d’entrée à faible latence (Windows 10)