WdfDeviceSetSpecialFileSupport-Funktion (wdfdevice.h)
[Gilt nur für KMDF]
Die WdfDeviceSetSpecialFileSupport-Methode aktiviert oder deaktiviert die Unterstützung eines Funktionstreibers für spezielle Dateien für das angegebene Gerät.
Syntax
void WdfDeviceSetSpecialFileSupport(
[in] WDFDEVICE Device,
[in] WDF_SPECIAL_FILE_TYPE FileType,
[in] BOOLEAN FileTypeIsSupported
);
Parameter
[in] Device
Ein Handle für ein Framework-Geräteobjekt.
[in] FileType
Ein WDF_SPECIAL_FILE_TYPE typisierter Enumerator, der den Typ der speziellen Datei identifiziert, die vom Treiber unterstützt wird.
[in] FileTypeIsSupported
Stellt einen booleschen Wert bereit, der bei TRUE die Unterstützung für den speziellen Dateityp aktiviert und bei FALSE die Unterstützung des speziellen Dateityps deaktiviert.
Rückgabewert
Keine
Bemerkungen
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Ein Funktionstreiber ruft in der Regel WdfDeviceSetSpecialFileSupport aus seiner EvtDriverDeviceAdd-Rückruffunktion auf.
Die Unterstützung für spezielle Dateien durch jeden Treiber wird zunächst deaktiviert, bis der Treiber WdfDeviceSetSpecialFileSupport aufruft.
Weitere Informationen finden Sie unter Unterstützen von Sonderdateien.
Beispiele
Im folgenden Codebeispiel wird die Unterstützung für Auslagerungs-, Ruhezustands- und Speicherabbilddateien auf einem Gerät aktiviert.
WdfDeviceSetSpecialFileSupport(
device,
WdfSpecialFilePaging,
TRUE
);
WdfDeviceSetSpecialFileSupport(
device,
WdfSpecialFileHibernation,
TRUE
);
WdfDeviceSetSpecialFileSupport(
device,
WdfSpecialFileDump,
TRUE
);
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 | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |