Función WdfDeviceAllocAndQueryInterfaceProperty (wdfdevice.h)

[Solo se aplica a UMDF]

El método WdfDeviceAllocAndQueryInterfaceProperty asigna un búfer y recupera una propiedad de interfaz de dispositivo especificada.

Sintaxis

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

Identificador de un objeto de dispositivo de marco.

[in] PropertyData

Puntero a una estructura de WDF_DEVICE_INTERFACE_PROPERTY_DATA que identifica la propiedad de interfaz de dispositivo que se va a recuperar.

[in] PoolType

Enumerador con tipo POOL_TYPE que especifica el tipo de memoria que se va a asignar.

[in, optional] PropertyMemoryAttributes

Puntero a una estructura de WDF_OBJECT_ATTRIBUTES asignada por el autor de la llamada que describe los atributos de objeto para el objeto de memoria que asignará la función. Este parámetro es opcional y se puede WDF_NO_OBJECT_ATTRIBUTES.

[out] PropertyMemory

Puntero a una ubicación con tipo WDFMEMORY que recibe un identificador para un objeto de memoria de marco.

[out] Type

Puntero a una variable con tipo DEVPROPTYPE que, devuelta, identifica el tipo de datos de propiedad contenidos en PropertyMemory.

Valor devuelto

Si el método WdfDeviceAllocAndQueryInterfaceProperty no encuentra ningún error, devuelve STATUS_SUCCESS. Entre los valores devueltos adicionales se incluyen:

Código devuelto	Descripción
STATUS_INVALID_PARAMETER	Uno de los parámetros es incorrecto.

 

El método podría devolver otros valores NTSTATUS.

Comentarios

El método WdfDeviceAllocAndQueryInterfaceProperty determina la cantidad de memoria necesaria para contener la propiedad de interfaz de dispositivo solicitada. Asigna suficiente memoria para contener los datos y devuelve un identificador a un objeto de memoria de marco que describe la memoria asignada. Para acceder a los datos, el controlador puede llamar a WdfMemoryGetBuffer.

Para obtener información sobre los métodos relacionados, consulte Acceso al modelo de propiedades de dispositivo unificado.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8.1
Plataforma de destino	Universal
Versión mínima de UMDF	2.0
Encabezado	wdfdevice.h (incluya Wdf.h)
Library	WUDFx02000.lib
Archivo DLL	WUDFx02000.dll
IRQL	PASSIVE_LEVEL

Consulte también

WDF_DEVICE_INTERFACE_PROPERTY_DATA

WDF_DEVICE_INTERFACE_PROPERTY_DATA_INIT

WdfDeviceAssignInterfaceProperty

WdfDeviceQueryInterfaceProperty