Auf Englisch lesen

Freigeben über


WdfDeviceInitSetRequestAttributes-Funktion (wdfdevice.h)

[Gilt für KMDF und UMDF]

Die WdfDeviceInitSetRequestAttributes Methode legt Objektattribute fest, die für alle Frameworkanforderungsobjekte verwendet werden, die vom Framework an den Treiber von den E/A-Warteschlangen des Geräts übermittelt werden.

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

Nichts

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 Using Request Object Context.

Das Framework verwendet nicht die angegebenen Objektattribute für Anforderungsobjekte, die es erstellt, wenn ein Treiber WdfRequestCreate oder WdfRequestCreateFromIrpaufruft.

Ihr Treiber muss WdfDeviceInitSetRequestAttributes innerhalb der EvtDriverDeviceAdd- Rückruffunktion aufrufen, bevor WdfDeviceCreateaufgerufen wird. Weitere Informationen finden Sie unter Erstellen eines Framework-Geräteobjekts.

Beispiele

Im folgenden Codebeispiel wird eine WDF_OBJECT_ATTRIBUTES Struktur initialisiert und WdfDeviceInitSetRequestAttributesaufgerufen.

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- Universal
Minimale KMDF-Version 1.0
Mindest-UMDF-Version 2.0
Header- wdfdevice.h (einschließen Wdf.h)
Library 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)

Siehe auch

EvtDriverDeviceAdd