Compartilhar via

Função WdfDeviceInitSetExclusive (wdfdevice.h)

  • Artigo

[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)

Confira também

EvtDriverDeviceAdd

WdfDeviceCreate