WdfDeviceInitSetRequestAttributes-Funktion (wdfdevice.h)
[Gilt für KMDF und UMDF]
Die WdfDeviceInitSetRequestAttributes-Methode legt Objektattribute fest, die für alle Frameworkanforderungsobjekte verwendet werden, die das Framework aus den E/A-Warteschlangen des Geräts an den Treiber übermittelt.
Syntax
void WdfDeviceInitSetRequestAttributes(
[in] PWDFDEVICE_INIT DeviceInit,
[in] PWDF_OBJECT_ATTRIBUTES RequestAttributes
);
Parameter
[in] DeviceInit
Ein vom Aufrufer bereitgestellter Zeiger auf eine WDFDEVICE_INIT-Struktur .
[in] RequestAttributes
Ein Zeiger auf eine vom Aufrufer zugewiesene WDF_OBJECT_ATTRIBUTES-Struktur , die Attribute für die Anforderungsobjekte des Geräts enthält.
Rückgabewert
Keine
Bemerkungen
Ihr Treiber kann WdfDeviceInitSetRequestAttributes aufrufen, um den Objektkontextbereich anzugeben, den das Framework den Anforderungsobjekten zuweist, die es für Ihren Treiber erstellt. Weitere Informationen zu diesem Kontextbereich finden Sie unter Verwenden des Anforderungsobjektkontexts.
Das Framework verwendet nicht die angegebenen Objektattribute für Anforderungsobjekte, die erstellt werden, wenn ein Treiber WdfRequestCreate oder WdfRequestCreateFromIrp aufruft.
Ihr Treiber muss WdfDeviceInitSetRequestAttributes aus seiner EvtDriverDeviceAdd-Rückruffunktion aufrufen, bevor WdfDeviceCreate aufgerufen wird. Weitere Informationen finden Sie unter Erstellen eines Framework-Geräteobjekts.
Beispiele
Im folgenden Codebeispiel wird eine WDF_OBJECT_ATTRIBUTES-Struktur initialisiert und WdfDeviceInitSetRequestAttributes aufgerufen.
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
);
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| UMDF-Mindestversion | 2.0 |
| Kopfzeile | wdfdevice.h (einschließen von Wdf.h) |
| Bibliothek | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf) |