Share via


WdfDeviceGetDefaultQueue, fonction (wdfdevice.h)

[S’applique à KMDF et UMDF]

La méthode WdfDeviceGetDefaultQueue retourne un handle à la file d’attente d’E/S par défaut d’un appareil.

Syntaxe

WDFQUEUE WdfDeviceGetDefaultQueue(
  [in] WDFDEVICE Device
);

Paramètres

[in] Device

Handle d’un objet d’appareil framework.

Valeur retournée

Si l’opération réussit, la méthode retourne un handle à un objet de file d’attente d’infrastructure. Si le pilote n’a pas créé de file d’E/S par défaut pour l’appareil, la méthode retourne NULL.

Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.

Remarques

Pour plus d’informations sur les files d’attente d’E/S par défaut, consultez Création de files d’attente d’E/S.

Exemples

L’exemple de code suivant obtient un handle dans la file d’attente d’E/S par défaut d’un appareil.

WDFQUEUE DefaultQueue;

DefaultQueue = WdfDeviceGetDefaultQueue(Device);

Configuration requise

Condition requise Valeur
Plateforme cible Universal
Version KMDF minimale 1.0
Version UMDF minimale 2.0
En-tête wdfdevice.h (include Wdf.h)
Bibliothèque Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
Règles de conformité DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)