Auf Englisch lesen

Freigeben über


WdfDeviceInitSetExclusive-Funktion (wdfdevice.h)

[Gilt nur für KMDF]

Die WdfDeviceInitSetExclusive Methode gibt an, ob ein angegebenes Gerät ein exklusives Gerät ist.

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, wenn TRUE, angibt, dass das Gerät ein exklusives Gerät ist. Wenn FALSE-, ist das Gerät kein exklusives Gerät.

Rückgabewert

Nichts

Bemerkungen

Wenn ein Treiber WdfDeviceInitSetExclusiveaufruft, muss er dies tun, bevor er WdfDeviceCreateaufruft.

Wenn ein Treiber WdfDeviceInitSetExclusiveaufruft, ist nur das Geräteobjekt dieses Treibers exklusiv. Um den gesamten Gerätestapel exklusiv zu machen, sollte die INF-Datei des Geräts eine INF-AddReg-Direktive enthalten, die einen Exclusive Eintrag auf TRUE in der Registrierung festlegt.

Weitere Informationen zum Aufrufen WdfDeviceCreatefinden Sie unter Creating a Framework Device Object.

Wenn Sie einen UMDF-Treiber schreiben, müssen Sie die INF-Datei des Treibers ändern oder Registrierungsänderungen vornehmen, um anzugeben, ob das Gerät exklusiv ist. Weitere Informationen zur Verwendung der Registrierung finden Sie unter Festlegen von Geräteobjektregistrierungseigenschaften während der Installation.

Beispiele

Im folgenden Codebeispiel wird angegeben, dass ein Gerät ein exklusives Gerät ist.

WdfDeviceInitSetExclusive(
                          DeviceInit,
                          TRUE
                          );

Anforderungen

Anforderung Wert
Zielplattform- Universal
Minimale KMDF-Version 1.0
Header- wdfdevice.h (einschließen Wdf.h)
Library Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.)
IRQL- <= DISPATCH_LEVEL
DDI-Complianceregeln ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

Siehe auch

EvtDriverDeviceAdd

WdfDeviceCreate