Función WdfDeviceInitSetRequestAttributes (wdfdevice.h)
[Se aplica a KMDF y UMDF]
El método WdfDeviceInitSetRequestAttributes establece atributos de objeto que se usarán para todos los objetos de solicitud de marco que el marco entrega al controlador desde las colas de E/S del dispositivo.
Sintaxis
void WdfDeviceInitSetRequestAttributes(
[in] PWDFDEVICE_INIT DeviceInit,
[in] PWDF_OBJECT_ATTRIBUTES RequestAttributes
);
Parámetros
[in] DeviceInit
Puntero proporcionado por el autor de la llamada a una estructura WDFDEVICE_INIT.
[in] RequestAttributes
Puntero a una estructura de WDF_OBJECT_ATTRIBUTES asignada por el autor de la llamada que contiene atributos para los objetos de solicitud del dispositivo.
Valor devuelto
Ninguno
Observaciones
El controlador puede llamar a WdfDeviceInitSetRequestAttributes para especificar el espacio de contexto del objeto que el marco asignará a los objetos de solicitud que crea para el controlador. Para obtener más información sobre este espacio de contexto, vea Using Request Object Context.
El marco de trabajo no usa los atributos de objeto especificados para los objetos de solicitud que crea cuando un controlador llama a WdfRequestCreate o WdfRequestCreateFromIrp.
El controlador debe llamar a función de devolución de llamada WdfDeviceInitSetRequestAttribute s desde su EvtDriverDeviceAdd función de devolución de llamada, antes de llamar a WdfDeviceCreate. Para obtener más información, vea Creación de un objeto de dispositivo framework.
Ejemplos
En el ejemplo de código siguiente se inicializa una estructura de WDF_OBJECT_ATTRIBUTES y se llama a WdfDeviceInitSetRequestAttributes.
typedef struct _REQUEST_CONTEXT {
ULONG_PTR Information;
} REQUEST_CONTEXT, *PREQUEST_CONTEXT;
WDF_OBJECT_ATTRIBUTES attributes;
WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(
&attributes,
REQUEST_CONTEXT
);
WdfDeviceInitSetRequestAttributes(
DeviceInit,
&attributes
);
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| versión mínima de KMDF | 1.0 |
| versión mínima de UMDF | 2.0 |
| encabezado de | wdfdevice.h (incluya Wdf.h) |
| biblioteca de | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| irQL | <= DISPATCH_LEVEL |
| reglas de cumplimiento de DDI | ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf) |