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

추가 정보

IObjectCleanup

IObjectCleanup::OnCleanup

IWDFDriver

IWDFObject

IWDFObject::D eleteWdfObject