Función WdfDeviceInitSetExclusive (wdfdevice.h)
[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) |