Funzione WdfDeviceGetDefaultQueue (wdfdevice.h)

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