Funzione WdfDeviceInitSetRequestAttributes (wdfdevice.h)
[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) |