WdfDeviceSetSpecialFileSupport-Funktion (wdfdevice.h)

  • Artikel

[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)

Weitere Informationen

EvtDriverDeviceAdd

WDF_SPECIAL_FILE_TYPE