Méthode IWDFIoRequest2 ::GetEffectiveIoType (wudfddi.h)

[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 GetEffectiveIoType retourne la méthode d’accès à la mémoire tampon qu’UMDF utilise pour les mémoires tampons de données de la demande d’E/S que représente l’interface IWDFIoRequest2 .

Syntaxe

WDF_DEVICE_IO_TYPE GetEffectiveIoType();

Valeur de retour

GetEffectiveIoType retourne une valeur de type WDF_DEVICE_IO_TYPE qui identifie la méthode d’accès à la mémoire tampon qu’UMDF utilise pour les mémoires tampons de données de la requête d’E/S.

Remarques

Pour plus d’informations sur l’accès aux mémoires tampons de données et le moment où votre pilote doit utiliser GetEffectiveIoType, consultez Accès aux mémoires tampons de données dans les pilotes UMDF-Based.

Exemples

L’exemple de code suivant montre comment une fonction de rappel IQueueCallbackWrite ::OnWrite peut obtenir la méthode d’accès à la mémoire tampon d’une demande d’E/S.

VOID
STDMETHODCALLTYPE
  CMyQueue::OnWrite(
    __in IWDFIoQueue *pWdfQueue,
    __in IWDFIoRequest *pWdfRequest,
    __in SIZE_T BytesToWrite
    )
{
    WDF_DEVICE_IO_TYPE currentIoType;

    //
    // Declare an IWDFIoRequest2 interface pointer and obtain the
    // IWDFIoRequest2 interface from the IWDFIoRequest interface.
    //
    CComQIPtr<IWDFIoRequest2> r2 = pWdfRequest;

    currentIoType = r2->GetEffectiveIoType();
...
}

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,9
En-tête	wudfddi.h (inclure Wudfddi.h)
DLL	WUDFx.dll

Voir aussi

IWDFIoRequest2

WDF_DEVICE_IO_TYPE (UMDF)