Função WdfPdoRemoveEjectionRelationsPhysicalDevice (wdfpdo.h)
[Aplica-se somente ao KMDF]
O método WdfPdoRemoveEjectionRelationsPhysicalDevice remove um dispositivo especificado da lista de dispositivos que devem ser ejetados quando outro dispositivo especificado é ejetado.
Sintaxe
void WdfPdoRemoveEjectionRelationsPhysicalDevice(
[in] WDFDEVICE Device,
[in] PDEVICE_OBJECT PhysicalDevice
);
Parâmetros
[in] Device
Um identificador para um objeto de dispositivo de estrutura.
[in] PhysicalDevice
Um ponteiro para uma estrutura de DEVICE_OBJECT fornecida pelo chamador que representa um PDO (objeto de dispositivo físico).
Valor de retorno
Nenhum
Observações
Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.
O parâmetro PhysicalDevice aponta para um PDO de um dispositivo que WdfPdoRemoveEjectionRelationsPhysicalDevice é removido da lista de dispositivos que devem ser ejetados quando o dispositivo representado pelo parâmetro dispositivo é ejetado.
Para obter mais informações, consulte suporte a dispositivos ejetáveis.
Exemplos
O exemplo de código a seguir remove o dispositivo que a estrutura pPhysicalDeviceObject representa da lista de dispositivos que são ejetados quando o dispositivo que dispositivo especificar é ejetado.
PDEVICE_OBJECT pPhysicalDeviceObject;
NTSTATUS status;
...
status = WdfPdoRemoveEjectionRelationsPhysicalDevice(
device,
pPhysicalDeviceObject
);
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| versão mínima do KMDF | 1.0 |
| cabeçalho | wdfpdo.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 | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |