Funzione WdfDeviceGetDefaultQueue (wdfdevice.h)

Articolo
02/27/2024

[Si applica a KMDF e UMDF]

Il metodo WdfDeviceGetDefaultQueue restituisce un handle alla coda di I/O predefinita di un dispositivo.

Sintassi

WDFQUEUE WdfDeviceGetDefaultQueue(
  [in] WDFDEVICE Device
);

Parametri

[in] Device

Handle per un oggetto dispositivo framework.

Valore restituito

Se l'operazione ha esito positivo, il metodo restituisce un handle a un oggetto coda del framework. Se il driver non ha creato una coda di I/O predefinita per il dispositivo, il metodo restituisce NULL.

Un controllo di bug si verifica se il driver fornisce un handle di oggetti non valido.

Commenti

Per altre informazioni sulle code di I/O predefinite, vedere Creazione di code di I/O predefinite.

Esempio

Nell'esempio di codice seguente viene ottenuto un handle per la coda di I/O predefinita di un dispositivo.

WDFQUEUE DefaultQueue;

DefaultQueue = WdfDeviceGetDefaultQueue(Device);

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.0
Versione UMDF minima	2,0
Intestazione	wdfdevice.h (includere Wdf.h)
Libreria	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
Regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Condividi tramite