Funzione WdfDeviceInitSetRequestAttributes (wdfdevice.h)

  • Articolo

[Si applica a KMDF e UMDF]

Il metodo WdfDeviceInitSetRequestAttributes imposta gli attributi dell'oggetto che verranno usati per tutti gli oggetti della richiesta del 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 di WDFDEVICE_INIT .

[in] RequestAttributes

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

Valore restituito

nessuno

Osservazioni

Il driver può chiamare WdfDeviceInitSetRequestAttributes per specificare lo spazio di contesto dell'oggetto che il framework assegna agli oggetti richiesta creati per il driver. Per altre informazioni su questo spazio di contesto, vedere Uso del contesto dell'oggetto richiesta.

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

Il driver deve chiamare WdfDeviceInitSetRequestAttributes dall'interno della sua funzione EvtDriverDeviceAdd callback, prima di chiamare WdfDeviceCreate. Per altre informazioni, vedere Creazione di un oggetto Dispositivo Framework.

Esempio

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

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.0
Versione UMDF minima 2,0
Intestazione wdfdevice.h (includere 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)

Vedi anche

EvtDriverDeviceAdd