WdfDeviceGetDefaultQueue, fonction (wdfdevice.h)

Article
02/07/2025

[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 vers un objet d’appareil framework.

Valeur de retour

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’attente d’E/S par défaut pour l’appareil, la méthode retourne NULL .

Une vérification de bogue 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);

Exigences

Exigence	Valeur
plateforme cible	Universel
version minimale de KMDF	1.0
version minimale de UMDF	2.0
d’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