WdfDeviceInitSetCharacteristics-Funktion (wdfdevice.h)
[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) |