Funzione WdfDeviceInitSetExclusive (wdfdevice.h)

  • Articolo

[Si applica solo a KMDF]

Il metodo WdfDeviceInitSetExclusive indica se un dispositivo specificato è un dispositivo esclusivo.

Sintassi

void WdfDeviceInitSetExclusive(
  [in] PWDFDEVICE_INIT DeviceInit,
  [in] BOOLEAN         IsExclusive
);

Parametri

[in] DeviceInit

Puntatore a una struttura WDFDEVICE_INIT .

[in] IsExclusive

Valore booleano che, se TRUE, indica che il dispositivo è un dispositivo esclusivo. Se FALSE, il dispositivo non è un dispositivo esclusivo.

Valore restituito

nessuno

Osservazioni

Se un driver chiama WdfDeviceInitSetExclusive, deve farlo prima di chiamare WdfDeviceCreate.

Se un driver chiama WdfDeviceInitSetExclusive, solo l'oggetto dispositivo del driver è esclusivo. Per rendere esclusivo l'intero stack di dispositivi di un dispositivo, il file INF del dispositivo deve includere una direttiva INF AddReg che imposta una voce esclusiva su TRUE nel Registro di sistema.

Per altre informazioni sulla chiamata a WdfDeviceCreate, vedere Creazione di un oggetto dispositivo framework.

Se si sta scrivendo un driver UMDF, è necessario modificare il file INF del driver o apportare modifiche al Registro di sistema per indicare se il dispositivo è esclusivo. Per altre informazioni sull'uso del Registro di sistema, vedere Impostazione delle proprietà del Registro oggetti dispositivo durante l'installazione.

Esempio

L'esempio di codice seguente indica che un dispositivo è un dispositivo esclusivo.

WdfDeviceInitSetExclusive(
                          DeviceInit,
                          TRUE
                          );

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.0
Intestazione wdfdevice.h (include Wdf.h)
Libreria Wdf01000.sys (vedere Controllo delle versioni della libreria framework).
IRQL <= DISPATCH_LEVEL
Regole di conformità DDI ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

Vedi anche

EvtDriverDeviceAdd

WdfDeviceCreate