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.
Valor de retorno
Nenhum
Observações
Se um driver chamar WdfDeviceInitSetExclusive, ele deverá fazê-lo antes de chamar WdfDeviceCreate.
Se um driver chamar WdfDeviceInitSetExclusive, somente o objeto de dispositivo do 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 para TRUE no registro.
Para obter mais informações sobre como chamar WdfDeviceCreate, consulte Criando um objeto de dispositivo framework.
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 Definindo propriedades do Registro de Objeto do 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 |
---|---|
da Plataforma de Destino | Universal |
versão mínima do KMDF | 1.0 |
cabeçalho | wdfdevice.h (inclua Wdf.h) |
biblioteca | Wdf01000.sys (consulte o Controle de Versão da Biblioteca da Estrutura.) |
IRQL | <= DISPATCH_LEVEL |
regras de conformidade de DDI | ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), kmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf) |