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