IWDFDevice3::CreateWorkItem 메서드(wudfddi.h)

아티클
02/27/2024

[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에 새 기능이 추가되지 않으며 최신 버전의 Windows 10 UMDF 1에 대한 지원이 제한되어 있습니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF를 사용하여 시작 참조하세요.]

CreateWorkItem 메서드는 프레임워크 작업 항목 개체를 만듭니다. 이 개체는 이후에 프레임워크의 작업 항목 큐에 추가할 수 있습니다.

구문

HRESULT CreateWorkItem(
  [in]           PWUDF_WORKITEM_CONFIG pConfig,
  [in, optional] IWDFObject            *pParentObject,
  [out]          IWDFWorkItem          **ppWorkItem
);

매개 변수

[in] pConfig

WUDF_WORKITEM_CONFIG_INIT 호출하여 드라이버가 이미 초기화해야 하는 호출자가 할당한 WUDF_WORKITEM_CONFIG 구조체에 대한 포인터입니다.

[in, optional] pParentObject

부모 개체 인터페이스 또는 NULL에 대한 포인터입니다.

[out] ppWorkItem

새 WorkItem 개체에 대한 IWDFWorkItem 인터페이스에 대한 포인터를 수신하는 버퍼에 대한 포인터입니다.

반환 값

메서드는 작업이 성공하면 S_OK 반환합니다. 그렇지 않으면 이 메서드는 Winerror.h에 정의된 오류 코드 중 하나를 반환합니다.

설명

부모 개체를 지정하면 부모 개체가 삭제되면 프레임워크에서 작업 항목을 자동으로 삭제합니다. 또는 드라이버가 IWDFObject::D eleteWdfObject 를 호출하여 작업 항목을 삭제할 수 있습니다. 드라이버는 OnWorkItem 콜백 함수에서 작업 항목을 삭제해서는 안됩니다.

자세한 내용은 작업 항목 사용을 참조하세요.

예제

WUDF_WORKITEM_CONFIG config;
        
WUDF_WORKITEM_CONFIG_INIT(&config, OnWorkItem); 
hr = m_IWdfDevice3->CreateWorkItem(&config,
                                   m_IWdfDevice3,   
                                   &m_WorkItem);

요구 사항

요구 사항	값
지원 종료	UMDF 2.0 이상에서는 사용할 수 없습니다.
대상 플랫폼	데스크톱
최소 UMDF 버전	1.11
머리글	wudfddi.h
DLL	WUDFx.dll