Função WdfDeviceAllocAndQueryInterfaceProperty (wdfdevice.h)

Artigo
02/07/2025

[Aplica-se somente ao UMDF]

O método WdfDeviceAllocAndQueryInterfaceProperty aloca um buffer e recupera uma propriedade de interface do dispositivo especificada.

Sintaxe

NTSTATUS WdfDeviceAllocAndQueryInterfaceProperty(
  [in]           WDFDEVICE                           Device,
  [in]           PWDF_DEVICE_INTERFACE_PROPERTY_DATA PropertyData,
  [in]           POOL_TYPE                           PoolType,
  [in, optional] PWDF_OBJECT_ATTRIBUTES              PropertyMemoryAttributes,
  [out]          WDFMEMORY                           *PropertyMemory,
  [out]          PDEVPROPTYPE                        Type
);

Parâmetros

[in] Device

Um identificador para um objeto de dispositivo de estrutura.

[in] PropertyData

Um ponteiro para uma estrutura de WDF_DEVICE_INTERFACE_PROPERTY_DATA que identifica a propriedade de interface do dispositivo a ser recuperada.

[in] PoolType

Um enumerador POOL_TYPEdigitado que especifica o tipo de memória a ser alocada.

[in, optional] PropertyMemoryAttributes

Um ponteiro para uma estrutura de WDF_OBJECT_ATTRIBUTES alocada pelo chamador que descreve atributos de objeto para o objeto de memória que a função alocará. Esse parâmetro é opcional e pode ser WDF_NO_OBJECT_ATTRIBUTES.

[out] PropertyMemory

Um ponteiro para um WDFMEMORYlocal tipado que recebe um identificador para um objeto de memória de estrutura.

[out] Type

Um ponteiro para uma variável deDEVPROPTYPE que, no retorno, identifica o tipo de dados de propriedade contidos em PropertyMemory.

Valor de retorno

Se o método WdfDeviceAllocAndQueryInterfaceProperty não encontrar erros, ele retornará STATUS_SUCCESS. Os valores de retorno adicionais incluem:

Código de retorno	Descrição
STATUS_INVALID_PARAMETER	Um dos parâmetros está incorreto.

O método pode retornar outros valores NTSTATUS .

Observações

O método WdfDeviceAllocAndQueryInterfaceProperty determina a quantidade de memória necessária para manter a propriedade de interface do dispositivo solicitada. Ele aloca memória suficiente para armazenar os dados e retorna um identificador para um objeto de memória de estrutura que descreve a memória alocada. Para acessar os dados, o driver pode chamar WdfMemoryGetBuffer.

Para obter informações sobre métodos relacionados, consulte Acessando o modelo de propriedade do dispositivo unificado.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 8.1
da Plataforma de Destino	Universal
versão mínima do UMDF	2.0
cabeçalho	wdfdevice.h (inclua Wdf.h)
biblioteca	WUDFx02000.lib
de DLL	WUDFx02000.dll
IRQL	PASSIVE_LEVEL

Consulte também

WDF_DEVICE_INTERFACE_PROPERTY_DATA

WDF_DEVICE_INTERFACE_PROPERTY_DATA_INIT

WdfDeviceAssignInterfaceProperty

WdfDeviceQueryInterfaceProperty

Compartilhar via