Compartilhar via

Função WdfDeviceSetPnpCapabilities (wdfdevice.h)

[Aplica-se a KMDF e UMDF]

O método WdfDeviceSetPnpCapabilities relata os recursos de Plug and Play de um dispositivo.

Sintaxe

VOID WdfDeviceSetPnpCapabilities(
  [in] WDFDEVICE                    Device,
  [in] PWDF_DEVICE_PNP_CAPABILITIES PnpCapabilities
);

Parâmetros

[in] Device

Um identificador para um objeto de dispositivo de estrutura.

[in] PnpCapabilities

Um ponteiro para uma estrutura de WDF_DEVICE_PNP_CAPABILITIES alocada pelo driver.

Valor de retorno

Nenhum

Observações

Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.

Um driver normalmente chama WdfDeviceSetPnpCapabilities de dentro de uma das seguintes funções de retorno de chamada:

  • EvtDriverDeviceAdd

  • EvtDevicePrepareHardware

  • EvtDeviceD0Entry (se o valor do parâmetro PreviousState for WdfPowerDeviceD3Final)

  • EvtDeviceSelfManagedIoInit

  • EvtChildListCreateDevice

Se mais de um driver na chamada de pilha de driver do dispositivo WdfDeviceSetPnpCapabilities, o gerenciador de Plug and Play usará os valores fornecidos pelo driver que é mais alto na pilha.

Exemplos

Os exemplos de código a seguir inicializam uma estrutura de WDF_DEVICE_PNP_CAPABILITIES e, em seguida, chamam WdfDeviceSetPnpCapabilities.

WDF_DEVICE_PNP_CAPABILITIES  pnpCaps;

WDF_DEVICE_PNP_CAPABILITIES_INIT(&pnpCaps);
pnpCaps.SurpriseRemovalOK = WdfTrue;

WdfDeviceSetPnpCapabilities(
                            device,
                            &pnpCaps
                            );

Requisitos

Requisito Valor
da Plataforma de Destino Universal
versão mínima do KMDF 1.0
versão mínima do UMDF 2.0
cabeçalho wdfdevice.h (inclua Wdf.h)
biblioteca Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
regras de conformidade de DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Consulte também

WDF_DEVICE_PNP_CAPABILITIES

WDF_DEVICE_PNP_CAPABILITIES_INIT

WdfDeviceSetPowerCapabilities

  • Last updated on