IWDFDriver::CreateWdfObject 메서드(wudfddi.h)
[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에는 새로운 기능이 추가되지 않으며 최신 버전의 Windows 10에서는 UMDF 1에 대한 지원이 제한되어 있습니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF시작 .]을 참조하세요.
CreateWdfObject 메서드는 부모 WDF 개체에서 사용자 지정(또는 사용자) WDF 개체를 만듭니다.
통사론
HRESULT CreateWdfObject(
[in, optional] IUnknown *pCallbackInterface,
[in, optional] IWDFObject *pParentObject,
[out] IWDFObject **ppWdfObject
);
매개 변수
[in, optional] pCallbackInterface
프레임워크에서 드라이버가 새로 만든 사용자 지정 개체에서 구독하는 개체 관련 이벤트 콜백 함수를 확인하는 데 사용하는 IUnknown 인터페이스에 대한 포인터입니다. 이 매개 변수는 선택 사항입니다. 드라이버에 알림이 필요하지 않은 경우 드라이버는 NULL 전달할 수 있습니다. 드라이버가 유효한 포인터를 전달하는 경우 프레임워크는 IObjectCleanup 인터페이스의 IUnknown 인터페이스에서 QueryInterface 호출합니다. 프레임워크가 드라이버의 IObjectCleanup 인터페이스를 가져오는 경우 프레임워크는 이후에 드라이버의 IObjectCleanup::OnCleanup 메서드를 호출하여 사용자 지정 개체가 정리되었음을 드라이버에 알릴 수 있습니다.
[in, optional] pParentObject
부모 WDF 개체의 IWDFObject 인터페이스에 대한 포인터입니다. NULL 경우 드라이버 개체가 기본 부모가 됩니다.
[out] ppWdfObject
새로 만든 WDF 개체에 대한 IWDFObject 인터페이스에 대한 포인터를 수신하는 버퍼에 대한 포인터입니다.
반환 값
CreateWdfObject 작업이 성공하면 S_OK 반환합니다. 그렇지 않으면 이 메서드는 Winerror.h에 정의된 오류 코드 중 하나를 반환합니다.
발언
드라이버는 CreateWdfObject 호출하여 고유한 용도로 일반 프레임워크 기본 개체 만들 수 있습니다. 드라이버는 컨텍스트 메모리를 연결하고, 부모 개체를 할당하고, IObjectCleanup 인터페이스를 등록할 수 있습니다. 프레임워크는 이후에 IObjectCleanup::OnCleanup 메서드를 호출하여 자식 개체를 정리합니다.
pParentObject 매개 변수에 부모 개체를 지정하지 않으면 드라이버가 기본 부모가 됩니다. 따라서 드라이버 개체가 삭제되면 프레임워크는 자식 개체를 정리합니다.
부모 개체가 할당된 경우 부모 개체가 삭제되면 자식 개체가 삭제됩니다. 즉, 자식 개체의 수명은 부모 개체의 수명 내에서 범위가 지정됩니다.
부모 개체를 삭제하기 전에 드라이버가 자식 개체를 정리해야 하는 경우 드라이버는 IWDFObject::D eleteWdfObject 메서드를 호출할 수 있습니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원 종료 | UMDF 2.0 이상에서는 사용할 수 없습니다. |
| 대상 플랫폼 | 바탕 화면 |
| 최소 UMDF 버전 | 1.5 |
| 헤더 | wudfddi.h(Wudfddi.h 포함) |
| DLL | WUDFx.dll |