Função WdfDeviceGetDefaultQueue (wdfdevice.h)

Artigo
02/07/2025

[Aplica-se a KMDF e UMDF]

O método WdfDeviceGetDefaultQueue retorna um identificador para a fila de E/S padrão de um dispositivo.

Sintaxe

WDFQUEUE WdfDeviceGetDefaultQueue(
  [in] WDFDEVICE Device
);

Parâmetros

[in] Device

Um identificador para um objeto de dispositivo de estrutura.

Valor de retorno

Se a operação for bem-sucedida, o método retornará um identificador para um objeto de fila de estrutura. Se o driver não criou uma fila de E/S padrão para o dispositivo, o método retornará NULL.

Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.

Observações

Para obter mais informações sobre filas de E/S padrão, consulte Criando filas de E/S.

Exemplos

O exemplo de código a seguir obtém um identificador para a fila de E/S padrão de um dispositivo.

WDFQUEUE DefaultQueue;

DefaultQueue = WdfDeviceGetDefaultQueue(Device);

Requisitos

Requisito	Valor
da Plataforma de Destino	Universal
versão mínima do KMDF	1.0
versão mínima do UMDF	2.0
cabeçalho	wdfdevice.h (inclua Wdf.h)
biblioteca	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
regras de conformidade de DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Compartilhar via