IWDFIoQueue ::ConfigureRequestDispatching, méthode (wudfddi.h)
[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 méthode ConfigureRequestDispatching configure la mise en file d’attente des requêtes d’E/S du type donné.
Syntaxe
HRESULT ConfigureRequestDispatching(
[in] WDF_REQUEST_TYPE RequestType,
[in] BOOL Forward
);
Paramètres
[in] RequestType
Valeur WDF_REQUEST_TYPE-typée qui identifie le type de requête à mettre en file d’attente. Les seules valeurs valides sont WdfRequestCreate, WdfRequestRead, WdfRequestWriteet WdfRequestDeviceIoControl.
[in] Forward
Valeur BOOL qui spécifie si les demandes du type spécifié sont mises en file d’attente. TRUE indique l’activation des requêtes de mise en file d’attente ; FALSE indique de désactiver les demandes de mise en file d’attente.
Valeur de retour
ConfigureRequestDispatching retourne S_OK si l’opération réussit. Sinon, cette méthode retourne l’un des codes d’erreur définis dans Winerror.h.
Remarques
Le pilote peut appeler la méthode ConfigureRequestDispatching plusieurs fois pour configurer la façon dont chaque type de requête est distribué à la file d’attente d’E/S.
Exemples
L’exemple de code suivant montre comment configurer le transfert pour les requêtes IOCTL.
//
// Configure forwarding for IOCTL requests
//
HRESULT hr = m_FxQueue->ConfigureRequestDispatching(
WdfRequestDeviceIoControl,
true
);
Exigences
| Exigence | Valeur |
|---|---|
| fin du support | Indisponible dans UMDF 2.0 et versions ultérieures. |
| plateforme cible | Bureau |
| version minimale de UMDF | 1.5 |
| d’en-tête | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |