WdfIoQueueRetrieveRequestByFileObject, fonction (wdfio.h)

[S’applique à KMDF et UMDF]

La méthode WdfIoQueueRetrieveRequestByFileObject récupère la requête d’E/S disponible suivante, à partir d’une file d’attente d’E/S spécifiée, associée à un objet de fichier spécifié.

Syntaxe

NTSTATUS WdfIoQueueRetrieveRequestByFileObject(
  [in]  WDFQUEUE      Queue,
  [in]  WDFFILEOBJECT FileObject,
  [out] WDFREQUEST    *OutRequest
);

Paramètres

[in] Queue

Handle vers un objet de file d’attente framework.

[in] FileObject

Handle d’un objet de fichier framework.

[out] OutRequest

Pointeur vers un emplacement qui reçoit un handle vers un objet de requête framework. Si WdfIoQueueRetrieveRequestByFileObject ne retourne pas STATUS_SUCCESS, elle ne définit pas la valeur de l’emplacement.

Valeur de retour

WdfIoQueueRetrieveRequestByFileObject retourne STATUS_SUCCESS si l’opération réussit. Sinon, cette méthode peut retourner l’une des valeurs suivantes :

Code de retour	Description
STATUS_INVALID_PARAMETER	Le pilote a fourni un handle non valide.
STATUS_NO_MORE_ENTRIES	L’infrastructure a atteint la fin de la file d’attente d’E/S.
STATUS_INVALID_DEVICE_STATE	La file d’attente d’E/S spécifiée est configurée pour la méthode de répartition parallèle.
STATUS_WDF_PAUSED	La file d’attente d’E/S spécifiée est géré par l’alimentation et son appareil est dans un état de faible alimentation.

 

Cette méthode peut également retourner d’autres valeurs NTSTATUS .

Une vérification de bogue se produit si le pilote fournit un handle d’objet non valide.

Remarques

Un pilote qui a configuré une file d’attente d’E/S pour la répartition manuelle ou séquentielle peut appeler WdfIoQueueRetrieveRequestByFileObject. Pour plus d’informations sur l’utilisation de WdfIoQueueRetrieveRequestByFileObject avec les méthodes de répartition manuelles ou séquentielles, consultez Méthodes de répartition pour les requêtes d’E/S.

Après avoir appelé WdfIoQueueRetrieveRequestByFileObject pour obtenir une demande d’E/S, le pilote possède la requête et doit traiter la requête d’E/S d’une certaine manière.

Pour plus d’informations sur la méthode WdfIoQueueRetrieveRequestByFileObject, consultez Gestion des files d’attente d’E/S.

Exemples

L’exemple de code suivant obtient, à partir d’une file d’attente d’E/S spécifiée, un handle à l’objet de requête d’infrastructure suivant associé à un objet de fichier framework spécifié.

WDFREQUEST  request;

status = WdfIoQueueRetrieveRequestByFileObject(
                                               queue,
                                               fileObject,
                                               &request
                                               );

Spécifications

Besoin	Valeur
plateforme cible	Universel
version minimale de KMDF	1.0
version minimale de UMDF	2.0
En-tête	wdfio.h (include Wdf.h)
Bibliothèque	Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
règles de conformité DDI	DoubleCompletion(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Voir aussi

WdfIoQueueRetrieveFoundRequest

WdfIoQueueRetrieveNextRequest