WdfDeviceInitSetCharacteristics-Funktion (wdfdevice.h)

Artikel
07.02.2025

[Gilt nur für KMDF]

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

Syntax

C++

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 vom System definierten ORed-Konstanten besteht, die Gerätemerkmale darstellen. Weitere Informationen finden Sie im Merkmale Member der DEVICE_OBJECT Struktur.

[in] OrInValues

Ein boolescher Wert. Wenn dieser Wert TRUEist, wird der DeviceCharacteristics- Wert mit vorhandenen Geräteeigenschaften entfernt. Wenn der Wert FALSE-ist, ersetzt die DeviceCharacteristics Wert vorhandene Gerätemerkmale.

Rückgabewert

Nichts

Bemerkungen

Rufen Sie zum Festlegen der Gerätemerkmale die WdfDeviceInitSetCharacteristics Methode in Ihrer EvtDriverDeviceAdd Rückruffunktion auf, bevor Sie WdfDeviceCreateaufrufen. Wenn Ihr Treiber die Merkmale eines Geräts erst ermitteln kann, nachdem die EvtDriverDeviceAdd Rückruffunktion zurückgegeben wurde, rufen Sie WdfDeviceSetCharacteristicsauf.

Weitere Informationen zum Aufrufen WdfDeviceCreatefinden Sie unter Creating a Framework Device Object.

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

Im folgenden Codebeispiel wird angegeben, dass ein Gerät ein Diskettendatenträger ist.

C++

WdfDeviceInitSetCharacteristics(
                                DeviceInit,
                                FILE_FLOPPY_DISKETTE,
                                FALSE
                                );

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Minimale KMDF-Version	1.0
Header-	wdfdevice.h (einschließen Wdf.h)
Library	Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.)
IRQL-	<= DISPATCH_LEVEL
DDI-Complianceregeln	ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

Siehe auch

WdfDeviceSetCharacteristics

Freigeben über