WdfDeviceInitSetCharacteristics-Funktion (wdfdevice.h)

  • Artikel

[Gilt nur für KMDF]

Die WdfDeviceInitSetCharacteristics-Methode legt Gerätemerkmale für ein angegebenes Gerät fest.

Syntax

void WdfDeviceInitSetCharacteristics(
  [in] PWDFDEVICE_INIT DeviceInit,
  [in] ULONG           DeviceCharacteristics,
  [in] BOOLEAN         OrInValues
);

Parameter

[in] DeviceInit

Ein Zeiger auf eine WDFDEVICE_INIT-Struktur .

[in] DeviceCharacteristics

Ein Wert, der aus systemdefinierten ORed-Konstanten besteht, die Gerätemerkmale darstellen. Weitere Informationen finden Sie im Element Characteristics der DEVICE_OBJECT-Struktur .

[in] OrInValues

Ein boolescher Wert. Wenn dieser Wert TRUE ist, wird der DeviceCharacteristics-Wert mit vorhandenen Gerätemerkmalen nicht mehr angezeigt. Wenn der Wert FALSE ist, ersetzt der DeviceCharacteristics-Wert vorhandene Gerätemerkmale.

Rückgabewert

Keine

Bemerkungen

Um Gerätemerkmale festzulegen, rufen Sie die WdfDeviceInitSetCharacteristics-Methode in Ihrer EvtDriverDeviceAdd-Rückruffunktion auf, bevor WdfDeviceCreate aufgerufen wird. Wenn Ihr Treiber die Merkmale eines Geräts erst ermitteln kann, nachdem die Rückruffunktion EvtDriverDeviceAdd zurückgegeben wurde, rufen Sie WdfDeviceSetCharacteristics auf.

Weitere Informationen zum Aufrufen von WdfDeviceCreate finden Sie unter Erstellen eines Framework-Geräteobjekts.

Das Framework legt immer das FILE_DEVICE_SECURE_OPEN Merkmal fest, sodass Ihr Treiber dieses Merkmal nicht festlegen muss.

Jeder Aufruf von WdfDeviceInitSetCharacteristics überschreibt die Einstellungen eines vorherigen Aufrufs.

Beispiele

Das folgende Codebeispiel gibt an, dass ein Gerät ein Diskettendatenträger ist.

WdfDeviceInitSetCharacteristics(
                                DeviceInit,
                                FILE_FLOPPY_DISKETTE,
                                FALSE
                                );

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.0
Kopfzeile wdfdevice.h (einschließen von Wdf.h)
Bibliothek Wdf01000.sys (siehe Versionsverwaltung der Frameworkbibliothek).)
IRQL <= DISPATCH_LEVEL
DDI-Complianceregeln ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

Weitere Informationen

WdfDeviceSetCharacteristics