WdfDeviceInitSetRequestAttributes-Funktion (wdfdevice.h)

  • Artikel

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

Weitere Informationen

EvtDriverDeviceAdd