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
None
Observaciones
El controlador puede llamar a WdfDeviceInitSetRequestAttributes para especificar el espacio de contexto de 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 Usar contexto de objeto de solicitud.
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 WdfDeviceInitSetRequestAttributes desde su evtDriverDeviceAdd función de devolución de llamada, antes de llamar a WdfDeviceCreate. Para obtener más información, consulte Creación de un objeto de dispositivo de marco.
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 | Value |
|---|---|
| Plataforma de destino | Universal |
| Versión mínima de KMDF | 1.0 |
| Versión mínima de UMDF | 2.0 |
| Encabezado | wdfdevice.h (incluya Wdf.h) |
| Library | 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) |