Função WdfDeviceAllocAndQueryInterfaceProperty (wdfdevice.h)

[Aplica-se somente ao UMDF]

O método WdfDeviceAllocAndQueryInterfaceProperty aloca um buffer e recupera uma propriedade de interface de 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 WDF_DEVICE_INTERFACE_PROPERTY_DATA que identifica a propriedade de interface do dispositivo a ser recuperada.

[in] PoolType

Um enumerador do tipo POOL_TYPE que especifica o tipo de memória a ser alocado.

[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 local do tipo WDFMEMORY que recebe um identificador para um objeto de memória de estrutura.

[out] Type

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

Retornar valor

Se o método WdfDeviceAllocAndQueryInterfaceProperty não encontrar erros, ele retornará STATUS_SUCCESS. Os valores retornados 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.

Comentários

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, seu driver pode chamar WdfMemoryGetBuffer.

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8.1
Plataforma de Destino	Universal
Versão mínima do UMDF	2,0
Cabeçalho	wdfdevice.h (inclua Wdf.h)
Biblioteca	WUDFx02000.lib
DLL	WUDFx02000.dll
IRQL	PASSIVE_LEVEL

Confira também

WDF_DEVICE_INTERFACE_PROPERTY_DATA

WDF_DEVICE_INTERFACE_PROPERTY_DATA_INIT

WdfDeviceAssignInterfaceProperty

WdfDeviceQueryInterfaceProperty