다음을 통해 공유

WdfDeviceAddDependentUsageDeviceObject 함수(wdfdevice.h)

  • 아티클

[KMDF에만 적용]

WdfDeviceAddDependentUsageDeviceObject 메서드는 지정된 디바이스가 특수 파일을 저장하는 데 사용될 때 지정된 디바이스가 다른 디바이스에 의존한다는 것을 나타냅니다.

구문

NTSTATUS WdfDeviceAddDependentUsageDeviceObject(
  [in] WDFDEVICE      Device,
  [in] PDEVICE_OBJECT DependentDevice
);

매개 변수

[in] Device

프레임워크 디바이스 개체에 대한 핸들입니다.

[in] DependentDevice

디바이스가 의존하는 디바이스를 식별하는 호출자 제공 DEVICE_OBJECT 구조체에 대한 포인터입니다.

반환 값

작업이 성공하면 WdfDeviceAddDependentUsageDeviceObject 메서드는 STATUS_SUCCESS 반환합니다. 추가 반환 값은 다음과 같습니다.

반환 코드 설명
STATUS_INVALID_PARAMETER
 DependentDevice 가 NULL입니다.
STATUS_INSUFFICIENT_RESOURCES
 메모리 할당에 실패했습니다.
 

메서드는 다른 NTSTATUS 값을 반환할 수 있습니다.

드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다.

설명

드라이버는 WdfDeviceAddDependentUsageDeviceObject를 호출하여 디바이스가 특수 파일을 지원할 때디바이스로 식별된 디바이스가 DependentDevice로 식별된 디바이스에 종속됨을 나타낼 수 있습니다. 드라이버가 WdfDeviceAddDependentUsageDeviceObject를 호출하는 경우 프레임워크는 디바이스 드라이버에서 EvtDeviceUsageNotification 콜백 함수를 호출하기 전에 DependentDevice의 드라이버에서 EvtDeviceUsageNotification 콜백 함수를 호출합니다.

드라이버는 WdfDeviceAddDependentUsageDeviceObject 를 여러 번 호출하여 디바이스 가 특수 파일을 지원하기 위해 의존하는 여러 디바이스를 식별할 수 있습니다.

드라이버가 WdfDeviceAddDependentUsageDeviceObject를 호출한 후 WdfDeviceRemoveDependentUsageDeviceObject를 호출하여 Device가 종속된 디바이스 목록에서 DependentDevice로 식별된 디바이스를 제거할 수 있습니다.

특수 파일에 대한 자세한 내용은 특수 파일 지원을 참조하세요.

예제

다음 코드 예제에서는 다른 디바이스(디바이스)가 의존하는 디바이스 목록에 디바이스(pDeviceObject)를 추가합니다.

status = WdfDeviceAddDependentUsageDeviceObject(
                                                device,
                                                pDeviceObject
                                                );

요구 사항

요구 사항 값
대상 플랫폼 유니버설
최소 KMDF 버전 1.0
머리글 wdfdevice.h(Wdf.h 포함)
라이브러리 Wdf01000.sys(프레임워크 라이브러리 버전 관리 참조)
IRQL <= DISPATCH_LEVEL
DDI 규정 준수 규칙 DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

추가 정보

EvtDeviceUsageNotification

WdfDeviceRemoveDependentUsageDeviceObject