Partilhar via


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)

Consulte também

EvtDriverDeviceAdd

WdfDeviceCreate