IWDFObject::D eleteWdfObject 메서드(wudfddi.h)
[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에 새 기능이 추가되지 않으며 최신 버전의 Windows 10 UMDF 1에 대한 지원이 제한되어 있습니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF를 사용하여 시작 참조하세요.]
DeleteWdfObject 메서드는 이전에 만든 WDF(Microsoft Windows Driver Frameworks) 개체를 삭제합니다.
구문
HRESULT DeleteWdfObject();
반환 값
DeleteWdfObject 는 작업이 성공하면 S_OK 반환합니다. 그렇지 않으면 이 메서드는 HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED) 또는 Winerror.h에 정의된 다른 오류 코드 중 하나를 반환합니다.
설명
드라이버가 일부 WDF 개체를 삭제할 수 없습니다. 예를 들어 프레임워크가 디바이스 개체 를 소유하고 제어하기 때문에 드라이버는 프레임워크 디바이스 개체를 삭제할 수 없습니다. WDF 개체의 계층 구조에 대한 자세한 내용은 Framework 개체 계층 구조를 참조하세요.
드라이버는 일반적으로 만들고 소유하는 WDF 개체만 삭제합니다. 프레임워크 개체를 삭제하는 방법에 대한 자세한 내용은 개체의 수명 관리를 참조하세요.
그러나 부모 개체가 삭제되면 모든 자식 개체가 자동으로 삭제됩니다. 예를 들어 드라이버가 I/O 큐 개체를 만들기 위해 IWDFDevice::CreateIoQueue 를 호출하는 경우 새로 만든 I/O 큐는 디바이스 개체의 자식이 됩니다. 그러면 드라이버가 DeleteWdfObject를 명시적으로 호출하지 않고 디바이스 개체가 삭제되면 I/O 큐 개체가 자동으로 삭제됩니다.
예제
DeleteWdfObject 메서드를 사용하는 방법에 대한 코드 예제는 IWDFDevice::SetPnpState를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원 종료 | UMDF 2.0 이상에서는 사용할 수 없습니다. |
| 대상 플랫폼 | 데스크톱 |
| 최소 UMDF 버전 | 1.5 |
| 머리글 | wudfddi.h(Wudfddi.h 포함) |
| DLL | WUDFx.dll |