Função WdfDeviceInitSetExclusive (wdfdevice.h)
[Aplica-se somente ao KMDF]
O método WdfDeviceInitSetExclusive indica se um dispositivo especificado é um dispositivo exclusivo.
Sintaxe
void WdfDeviceInitSetExclusive(
[in] PWDFDEVICE_INIT DeviceInit,
[in] BOOLEAN IsExclusive
);
Parâmetros
[in] DeviceInit
Um ponteiro para uma estrutura WDFDEVICE_INIT .
[in] IsExclusive
Um valor booliano que, se VERDADEIRO, indica que o dispositivo é um dispositivo exclusivo. Se FALSE, o dispositivo não será um dispositivo exclusivo.
Retornar valor
Nenhum
Comentários
Se um driver chamar WdfDeviceInitSetExclusive, ele deverá fazer isso antes de chamar WdfDeviceCreate.
Se um driver chamar WdfDeviceInitSetExclusive, somente o objeto de dispositivo desse driver será exclusivo. Para tornar toda a pilha de dispositivos exclusiva de um dispositivo, o arquivo INF do dispositivo deve incluir uma diretiva INF AddReg que define uma entrada Exclusive como TRUE no registro.
Para obter mais informações sobre como chamar WdfDeviceCreate, consulte Criando um objeto de dispositivo de estrutura.
Se você estiver escrevendo um driver UMDF, deverá modificar o arquivo INF do driver ou fazer alterações no Registro para indicar se o dispositivo é exclusivo. Para obter mais informações sobre como usar o Registro, consulte Configurando propriedades do Registro de Objeto de Dispositivo durante a instalação.
Exemplos
O exemplo de código a seguir indica que um dispositivo é um dispositivo exclusivo.
WdfDeviceInitSetExclusive(
DeviceInit,
TRUE
);
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Versão mínima do KMDF | 1.0 |
| Cabeçalho | wdfdevice.h (inclua Wdf.h) |
| Biblioteca | Wdf01000.sys (consulte Controle de versão da biblioteca de estrutura.) |
| IRQL | <= DISPATCH_LEVEL |
| Regras de conformidade da DDI | ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf) |