Méthode IWDFIoQueue ::ConfigureRequestDispatching (wudfddi.h)

Article
03/01/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.]

La méthode ConfigureRequestDispatching configure la mise en file d’attente des demandes d’E/S du type donné.

Syntaxe

HRESULT ConfigureRequestDispatching(
  [in] WDF_REQUEST_TYPE RequestType,
  [in] BOOL             Forward
);

Paramètres

[in] RequestType

Valeur de type WDF_REQUEST_TYPE qui identifie le type de requête à mettre en file d’attente. Les seules valeurs valides sont WdfRequestCreate, WdfRequestRead, WdfRequestWrite et WdfRequestDeviceIoControl.

[in] Forward

Valeur BOOL qui spécifie si les demandes du type spécifié sont mises en file d’attente. TRUE indique d’activer les demandes de file d’attente ; FALSE indique de désactiver les demandes de mise en file d’attente.

Valeur retournée

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 demandes IOCTL.

    //
    // Configure forwarding for IOCTL requests
    //
    HRESULT hr = m_FxQueue->ConfigureRequestDispatching(
                                                        WdfRequestDeviceIoControl,
                                                        true
                                                        );

Configuration requise

Condition requise	Valeur
Fin de la prise en charge	Non disponible dans UMDF 2.0 et versions ultérieures.
Plateforme cible	Desktop (Expérience utilisateur)
Version UMDF minimale	1.5
En-tête	wudfddi.h (inclure Wudfddi.h)
DLL	WUDFx.dll

Voir aussi

IWDFIoQueue

WDF_REQUEST_TYPE

Partager via