Función WdfDeviceInitSetExclusive (wdfdevice.h)

  • Artículo

[Solo se aplica a KMDF]

El método WdfDeviceInitSetExclusive indica si un dispositivo especificado es un dispositivo exclusivo.

Sintaxis

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

Parámetros

[in] DeviceInit

Puntero a una estructura de WDFDEVICE_INIT .

[in] IsExclusive

Valor booleano que, si es TRUE, indica que el dispositivo es un dispositivo exclusivo. Si es FALSE, el dispositivo no es un dispositivo exclusivo.

Valor devuelto

None

Observaciones

Si un controlador llama a WdfDeviceInitSetExclusive, debe hacerlo antes de llamar a WdfDeviceCreate.

Si un controlador llama a WdfDeviceInitSetExclusive, solo el objeto de dispositivo del controlador es exclusivo. Para que toda la pila de dispositivos de un dispositivo sea exclusiva, el archivo INF del dispositivo debe incluir una directiva AddReg inf que establezca una entrada Exclusiva en TRUE en el Registro.

Para obtener más información sobre cómo llamar a WdfDeviceCreate, vea Creating a Framework Device Object.

Si está escribiendo un controlador UMDF, debe modificar el archivo INF del controlador o realizar cambios en el Registro para indicar si el dispositivo es exclusivo. Para obtener más información sobre cómo usar el Registro, vea Establecer propiedades del Registro de objetos de dispositivo durante la instalación.

Ejemplos

En el ejemplo de código siguiente se indica que un dispositivo es un dispositivo exclusivo.

WdfDeviceInitSetExclusive(
                          DeviceInit,
                          TRUE
                          );

Requisitos

Requisito Value
Plataforma de destino Universal
Versión mínima de KMDF 1.0
Encabezado wdfdevice.h (incluir Wdf.h)
Library Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos).
IRQL <= DISPATCH_LEVEL
Reglas de cumplimiento de DDI ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

Consulte también

EvtDriverDeviceAdd

WdfDeviceCreate