Função WdfDeviceInitSetRequestAttributes (wdfdevice.h)

[Aplica-se a KMDF e UMDF]

O método WdfDeviceInitSetRequestAttributes define atributos de objeto que serão usados para todos os objetos de solicitação de estrutura que a estrutura fornece ao driver das filas de E/S do dispositivo.

Sintaxe

void WdfDeviceInitSetRequestAttributes(
  [in] PWDFDEVICE_INIT        DeviceInit,
  [in] PWDF_OBJECT_ATTRIBUTES RequestAttributes
);

Parâmetros

[in] DeviceInit

Um ponteiro fornecido pelo chamador para uma estrutura de WDFDEVICE_INIT .

[in] RequestAttributes

Um ponteiro para uma estrutura de WDF_OBJECT_ATTRIBUTES alocada pelo chamador que contém atributos para os objetos de solicitação do dispositivo.

Valor retornado

Nenhum

Comentários

Seu driver pode chamar WdfDeviceInitSetRequestAttributes para especificar o espaço de contexto de objeto que a estrutura atribuirá aos objetos de solicitação que ele cria para o driver. Para obter mais informações sobre esse espaço de contexto, consulte Using Request Object Context.

A estrutura não usa os atributos de objeto especificados para objetos de solicitação que cria quando um driver chama WdfRequestCreate ou WdfRequestCreateFromIrp.

Seu driver deve chamar WdfDeviceInitSetRequestAttributes de dentro de sua função de retorno de chamada EvtDriverDeviceAdd , antes de chamar WdfDeviceCreate. Para obter mais informações, consulte Criando um objeto de dispositivo framework.

Exemplos

O exemplo de código a seguir inicializa uma estrutura de WDF_OBJECT_ATTRIBUTES e chama 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

   
Plataforma de Destino Universal
Versão mínima do KMDF 1,0
Versão mínima do UMDF 2,0
Cabeçalho wdfdevice.h (include Wdf.h)
Biblioteca Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
Regras de conformidade de DDI ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

Confira também

EvtDriverDeviceAdd