Función WdfDeviceAllocAndQueryPropertyEx (wdfdevice.h)
[Se aplica a KMDF y UMDF]
El método WdfDeviceAllocAndQueryPropertyEx asigna un búfer y recupera una propiedad de dispositivo especificada.
Sintaxis
NTSTATUS WdfDeviceAllocAndQueryPropertyEx(
[in] WDFDEVICE Device,
[in] PWDF_DEVICE_PROPERTY_DATA DeviceProperty,
[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] DeviceProperty
Puntero a una estructura de WDF_DEVICE_PROPERTY_DATA que identifica la propiedad del dispositivo que se va a recuperar.
[in] PoolType
Enumerador con tipo POOL_TYPEque 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 de un objeto de memoria de marco.
[out] Type
Puntero a una variable de DEVPROPTYPE. Si el método se ejecuta correctamente, tras devolver este parámetro contiene el valor de tipo de propiedad de los datos de propiedad almacenados en PropertyMemory.
Valor devuelto
Si la operación se realiza correctamente, WdfDeviceAllocAndQueryPropertyEx devuelve STATUS_SUCCESS. Entre los valores devueltos adicionales se incluyen:
| Código devuelto | Descripción |
|---|---|
|
El valor de DeviceProperty especificado no es válido. |
El método podría devolver otros valores ntstatus de .
Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.
Observaciones
Puede usar WdfDeviceAllocAndQueryPropertyEx para recuperar cualquier propiedad expuesta a través del modelo de propiedades unificado, mientras que el método WdfDeviceAllocAndQueryProperty solo permite consultar un subconjunto del modelo de propiedades unificado.
El método WdfDeviceAllocAndQueryPropertyEx 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 | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| versión mínima de KMDF | 1.13 |
| versión mínima de UMDF | 2.0 |
| encabezado de | wdfdevice.h (incluya Wdf.h) |
| biblioteca de | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| irQL | APC_LEVEL |