Compartilhar via

Função WdfDeviceInitSetRequestAttributes (wdfdevice.h)

  • Artigo

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

Retornar valor

Nenhum

Comentários

Seu driver pode chamar WdfDeviceInitSetRequestAttributes para especificar o espaço de contexto do 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 Usando o contexto do objeto request.

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 de estrutura.

Exemplos

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

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.0
Versão mínima do UMDF 2,0
Cabeçalho wdfdevice.h (inclua 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