Función WdfDeviceInitSetRequestAttributes (wdfdevice.h)

  • Artículo

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

Consulte también

EvtDriverDeviceAdd