WdfDeviceInitSetExclusive-Funktion (wdfdevice.h)
[Gilt nur für KMDF]
Die WdfDeviceInitSetExclusive-Methode gibt an, ob es sich bei einem angegebenen Gerät um ein exklusives Gerät handelt.
Syntax
void WdfDeviceInitSetExclusive(
[in] PWDFDEVICE_INIT DeviceInit,
[in] BOOLEAN IsExclusive
);
Parameter
[in] DeviceInit
Ein Zeiger auf eine WDFDEVICE_INIT-Struktur .
[in] IsExclusive
Ein boolescher Wert, der bei TRUE angibt, dass es sich bei dem Gerät um ein exklusives Gerät handelt. Bei FALSE ist das Gerät kein exklusives Gerät.
Rückgabewert
Keine
Bemerkungen
Wenn ein Treiber WdfDeviceInitSetExclusive aufruft, muss er dies tun, bevor er WdfDeviceCreate aufruft.
Wenn ein Treiber WdfDeviceInitSetExclusive aufruft, ist nur das Geräteobjekt dieses Treibers exklusiv. Damit der gesamte Gerätestapel eines Geräts exklusiv ist, sollte die INF-Datei des Geräts eine INF AddReg-Direktive enthalten, die einen Exklusiven Eintrag in der Registrierung auf TRUE festlegt.
Weitere Informationen zum Aufrufen von WdfDeviceCreate finden Sie unter Erstellen eines Framework-Geräteobjekts.
Wenn Sie einen UMDF-Treiber schreiben, müssen Sie die INF-Datei Ihres Treibers ändern oder Registrierungsänderungen vornehmen, um anzugeben, ob das Gerät exklusiv ist. Weitere Informationen zur Verwendung der Registrierung finden Sie unter Festlegen der Eigenschaften der Geräteobjektregistrierung während der Installation.
Beispiele
Das folgende Codebeispiel zeigt an, dass es sich bei einem Gerät um ein exklusives Gerät handelt.
WdfDeviceInitSetExclusive(
DeviceInit,
TRUE
);
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| Kopfzeile | wdfdevice.h (einschließen von Wdf.h) |
| Bibliothek | Wdf01000.sys (siehe Versionierung der Frameworkbibliothek.) |
| IRQL | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf) |