WdfDeviceInitSetExclusive-Funktion (wdfdevice.h)

  • Artikel

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

Weitere Informationen

EvtDriverDeviceAdd

WdfDeviceCreate