énumération WDF_REQUEST_TYPE (wudfddi_types.h)

Article
03/05/2024

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

L’énumération WDF_REQUEST_TYPE identifie les types de demandes d’E/S qu’un objet de requête UMDF peut représenter.

Syntax

typedef enum _WDF_REQUEST_TYPE {
  WdfRequestUndefined,
  WdfRequestCreate,
  WdfRequestCleanup,
  WdfRequestRead,
  WdfRequestWrite,
  WdfRequestDeviceIoControl,
  WdfRequestClose,
  WdfRequestUsb,
  WdfRequestOther,
  WdfRequestInternalIoctl,
  WdfRequestTypeNoFormat,
  WdfRequestFlushBuffers,
  WdfRequestQueryInformation,
  WdfRequestSetInformation,
  WdfRequestMaximum
} WDF_REQUEST_TYPE, *PWDF_REQUEST_TYPE;

Constantes


`WdfRequestUndefined` Le type de l’objet de requête n’est pas défini.
`WdfRequestCreate` L’objet request représente une demande de création de fichier. Le pilote reçoit ce type d’objet de requête lorsqu’une application ouvre un appareil en appelant la fonction CreateFile Microsoft Win32. L’infrastructure fournit ce type de requête, ainsi qu’un objet de fichier nouvellement créé (IWDFFile), à la fonction de rappel IQueueCallbackCreate ::OnCreateFile du pilote. Le nouvel objet de fichier représente le handle de fichier de type HANDLE que le CreateFile Win32 retourne.
`WdfRequestCleanup` L’objet request représente une demande de nettoyage de fichier. Le pilote reçoit ce type d’objet de requête après que l’appel d’une application à la fonction Win32 CloseHandle ferme le dernier handle à un objet de fichier, mais peut-être avant que toutes les demandes d’E/S en suspens du fichier aient été terminées ou annulées. L’infrastructure fournit ce type de requête à la fonction de rappel IFileCallbackCleanup ::OnCleanupFile du pilote. (Voir également WdfRequestClose.)
`WdfRequestRead` L’objet request représente une demande de lecture. Ce pilote reçoit ce type de demande d’E/S lorsqu’une application appelle la fonction Win32 ReadFile ou ReadFileEx . L’infrastructure fournit ce type de requête à la fonction de rappel IQueueCallbackRead ::OnRead du pilote.
`WdfRequestWrite` L’objet request représente une demande d’écriture. Ce pilote reçoit ce type de demande d’E/S lorsqu’une application appelle la fonction Win32 WriteFile ou WriteFileEx . L’infrastructure fournit ce type de requête à la fonction de rappel IQueueCallbackWrite ::OnWrite du pilote.
`WdfRequestDeviceIoControl` L’objet de requête représente une demande de contrôle d’E/S d’appareil. Ce pilote reçoit ce type de demande d’E/S lorsqu’une application appelle la fonction Win32 DeviceIoControl . L’infrastructure fournit ce type de requête à la fonction de rappel IQueueCallbackDeviceIoControl ::OnDeviceIoControl du pilote.
`WdfRequestClose` L’objet request représente une demande de fermeture de fichier. Le pilote reçoit ce type d’objet de requête après que l’appel d’une application à la fonction Win32 CloseHandle ferme le dernier handle à un objet de fichier et une fois que toutes les demandes d’E/S en suspens du fichier ont été terminées ou annulées. L’infrastructure transmet ce type de requête à la fonction de rappel IFileCallbackClose ::OnCloseFile du pilote. (Voir également WdfRequestCleanup.)
`WdfRequestUsb` L’objet de requête a été envoyé à un port USB. La méthode IWDFRequestCompletionParams ::GetCompletedRequestType peut retourner cette valeur.
`WdfRequestOther` Cette valeur est réservée à un usage interne uniquement.
`WdfRequestInternalIoctl` Cette valeur est réservée à un usage interne uniquement.
`WdfRequestTypeNoFormat` Le type de l’objet de requête n’a pas été spécifié.
`WdfRequestFlushBuffers` L’objet request représente une demande de vidage des mémoires tampons mises en cache. L’infrastructure fournit ce type de requête à la fonction de rappel IQueueCallbackDefaultIoHandler ::OnDefaultIoHandler du pilote.
`WdfRequestQueryInformation` L’objet request représente une demande d’obtention d’informations sur un fichier. L’infrastructure fournit ce type de requête à la fonction de rappel IQueueCallbackDefaultIoHandler ::OnDefaultIoHandler du pilote.
`WdfRequestSetInformation` L’objet request représente une demande pour définir des informations sur un fichier. L’infrastructure fournit ce type de requête à la fonction de rappel IQueueCallbackDefaultIoHandler ::OnDefaultIoHandler du pilote.
`WdfRequestMaximum` La valeur maximale de l’énumération est dépassée.