IRemoteInterfaceCallbackEvent ::OnRemoteInterfaceEvent, méthode (wudfddi.h)

Article
02/07/2025

[Avertissement : UMDF 2 est la dernière version de UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide de UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et il existe une prise en charge limitée de UMDF 1 sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Bien démarrer avec UMDF.]

La fonction de rappel d’événements du pilote UMDF onRemoteInterfaceEvent gère les événements d’appareil associés à une interface d’appareil .

Syntaxe

void OnRemoteInterfaceEvent(
  [in]           IWDFRemoteInterface *pWdfRemoteInterface,
  [in]           REFGUID             EventGuid,
  [in, optional] BYTE                *pbData,
  [in]           DWORD               cbDataSize,
  [in]           DWORD               NameBufferOffset
);

Paramètres

[in] pWdfRemoteInterface

Pointeur vers l’interface IWDFRemoteInterface d’un objet d’interface distante qui représente une interface d’appareil. Le pilote obtient ce pointeur lorsqu’il appelle IWDFDevice2 ::CreateRemoteInterface.

[in] EventGuid

GUID qui identifie le type d’événement. Les GUID d’événement sont définis par les composants qui prennent en charge ces GUID. Certaines classes d’interface d’appareil fournissent des GUID d’événements, et certains pilotes fournissent des événements personnalisés.

[in, optional] pbData

Pointeur vers une mémoire tampon qui contient des données spécifiques à l’événement. En règle générale, les composants qui définissent des GUID d’événement définissent également des structures spécifiques aux événements pour les mémoires tampons d’événements.

[in] cbDataSize

Taille, en octets, de la mémoire tampon vers laquelle pbData pointe.

[in] NameBufferOffset

Offset, en octets, du début de la mémoire tampon vers laquelle pbData pointe. Les octets de 0 à NameBufferOffset-1 de la mémoire tampon contiennent des données binaires. Les octets de NameBufferOffset à la fin de la mémoire tampon contiennent des données de chaîne Unicode.

Valeur de retour

Aucun

Remarques

Le OnRemoteInterfaceEvent d’un pilote fonction de rappel d’événement gère tous les événements d’appareil, à l’exception des événements d’arrivée et de suppression. Ces événements peuvent provenir de l’appel d’un pilote basé sur UMDF à IWDFDevice ::P ostEvent ou de l’appel d’un pilote en mode noyau à IoReportTargetDeviceChange ou IoReportTargetDeviceChangeAsynchronous.

L’infrastructure commence à appeler la fonction de rappel d’événement OnRemoteInterfaceEvent après que le pilote appelle IWDFRemoteTarget ::OpenRemoteInterface et continue à appeler la fonction de rappel jusqu’à ce que l’interface de l’appareil cible d’E/S distante soit fermée.

Pour plus d’informations sur la fonction de rappel d’événements OnRemoteInterfaceEvent d’un pilote, consultez Utilisation des interfaces de périphérique dans les pilotes basés sur UMDF.

Exigences

Exigence	Valeur
fin du support	Indisponible dans UMDF 2.0 et versions ultérieures.
plateforme cible	Bureau
version minimale de UMDF	1.9
d’en-tête	wudfddi.h (include Wudfddi.h)

Voir aussi

IPnpCallbackRemoteInterfaceNotification ::OnRemoteInterfaceArrival

IRemoteInterfaceCallbackEvent

IRemoteInterfaceCallbackRemoval ::OnRemoteInterfaceRemoval

Partager via