[KMDF에만 적용]
WdfPdoAddEjectionRelationsPhysicalDevice 메서드는 지정된 다른 디바이스가 배출될 때 지정된 디바이스가 배출됨을 나타냅니다.
구문론
NTSTATUS WdfPdoAddEjectionRelationsPhysicalDevice(
[in] WDFDEVICE Device,
[in] PDEVICE_OBJECT PhysicalDevice
);
매개 변수
[in] Device
프레임워크 디바이스 개체에 대한 핸들입니다.
[in] PhysicalDevice
PDO(물리적 디바이스 개체)를 나타내는 호출자 제공 DEVICE_OBJECT 구조체에 대한 포인터입니다.
반환 값
작업이 성공하면 메서드는 STATUS_SUCCESS 반환합니다. 추가 반환 값은 다음과 같습니다.
| 반환 코드 | 설명 |
|---|---|
|
입력 매개 변수가 NULL . |
|
메모리 할당에 실패했습니다. |
이 메서드는 다른NTSTATUS 값을 반환할 수도 있습니다.
드라이버가 잘못된 개체 핸들을 제공하는 경우 시스템 버그 검사가 발생합니다.
비고
PhysicalDevice 매개 변수는 디바이스 의해 식별되는 디바이스가 배출될 때 배출되는 디바이스의 PDO를 가리킵니다. 일반적으로 두 디바이스는 호출 드라이버에 의해 제어됩니다. PnP 관리자가 부모 디바이스를 꺼내면 디바이스의 자식도 내보내므로 디바이스 자식 디바이스를 보고하지 마세요.
자세한 내용은 ejectable Devices지원합니다.
예시
다음 코드 예제에서는 pPhysicalDeviceObject 구조가 나타내는 디바이스를 디바이스 지정한 디바이스가 배출될 때 배출되는 디바이스 목록에 추가합니다.
PDEVICE_OBJECT pPhysicalDeviceObject;
NTSTATUS status;
...
status = WdfPdoAddEjectionRelationsPhysicalDevice(
device,
pPhysicalDeviceObject
);
요구 사항
| 요구 사항 | 가치 |
|---|---|
| 대상 플랫폼 | 보편적 |
| 최소 KMDF 버전 | 1.0 |
| 헤더 | wdfpdo.h(Wdf.h 포함) |
| 라이브러리 | Wdf01000.sys(프레임워크 라이브러리 버전 관리 참조) |
| IRQL | <= 디스패치_레벨 |
| DDI 규정 준수 규칙 | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |