WdfDeviceGetDefaultQueue, fonction (wdfdevice.h)

Article
02/27/2024

[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)

Partager via