Funzione WdfDeviceInitSetRequestAttributes (wdfdevice.h)

Articolo
02/07/2025

[Si applica a KMDF e UMDF]

Il metodo WdfDeviceInitSetRequestAttributes metodo imposta gli attributi dell'oggetto che verranno usati per tutti gli oggetti richiesta framework che il framework recapita al driver dalle code di I/O del dispositivo.

Sintassi

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

Parametri

[in] DeviceInit

Puntatore fornito dal chiamante a una struttura WDFDEVICE_INIT.

[in] RequestAttributes

Puntatore a una struttura di WDF_OBJECT_ATTRIBUTES allocata dal chiamante che contiene gli attributi per gli oggetti richiesta del dispositivo.

Valore restituito

Nessuno

Osservazioni

Il driver può chiamare WdfDeviceInitSetRequestAttributes per specificare lo spazio del contesto dell'oggetto che il framework assegnerà agli oggetti richiesta creati per il driver. Per altre informazioni su questo spazio di contesto, vedere Using Request Object Context.

Il framework non usa gli attributi dell'oggetto specificati per gli oggetti richiesta creati quando un driver chiama WdfRequestCreate o WdfRequestCreateFromIrp.

Il driver deve chiamare funzione di callback WdfDeviceInitSetRequestAttribute s da funzione di callback EvtDriverDeviceAdd prima di chiamare WdfDeviceCreate. Per altre informazioni, vedere Creazione di un oggetto dispositivo framework.

Esempi

L'esempio di codice seguente inizializza una struttura WDF_OBJECT_ATTRIBUTES e chiama 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
                                  );

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
versione minima di KMDF	1.0
versione minima di UMDF	2.0
intestazione	wdfdevice.h (include Wdf.h)
libreria	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
regole di conformità DDI	ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

Vedere anche

EvtDriverDeviceAdd

Condividi tramite