WdfObjectCreate 함수(wdfobject.h)
[KMDF 및 UMDF에 적용]
WdfObjectCreate 메서드는 일반 프레임워크 개체를 만듭니다.
구문
NTSTATUS WdfObjectCreate(
[in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
[out] WDFOBJECT *Object
);
매개 변수
[in, optional] Attributes
새 개체에 대해 드라이버 제공 특성을 포함하는 WDF_OBJECT_ATTRIBUTES 구조체에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 WDF_NO_OBJECT_ATTRIBUTES 수 있습니다.
[out] Object
새 프레임워크 개체에 대한 핸들을 수신하는 위치에 대한 포인터입니다.
반환 값
WdfObjectCreate 는 작업이 성공하면 STATUS_SUCCESS 반환합니다. 추가 반환 값 목록은 프레임워크 개체 만들기 오류를 참조하세요.
이 메서드는 다른 NTSTATUS 값을 반환할 수도 있습니다.
설명
기본적으로 새 일반 프레임워크 개체의 부모는 WdfDriverCreate 메서드가 만든 프레임워크 드라이버 개체입니다. WDF_OBJECT_ATTRIBUTES 구조체의 ParentObject 멤버를 사용하여 다른 부모를 지정할 수 있습니다. 프레임워크는 부모 개체를 삭제할 때 일반 개체를 삭제합니다. 드라이버가 기본 부모를 변경하지 않으면 드라이버가 개체 사용을 마쳤을 때 일반 개체를 삭제해야 합니다. 그렇지 않으면 I/O 관리자가 드라이버를 언로드할 때까지 개체가 유지됩니다.
WdfObjectCreate 메서드에 대한 자세한 내용은 일반 프레임워크 개체 사용을 참조하세요.
프레임워크 개체 계층 구조의 정리 규칙에 대한 자세한 내용은 Framework 개체 수명 주기를 참조하세요.
예제
다음 코드 예제에서는 WDF_OBJECT_ATTRIBUTES 구조를 초기화하고 일반 프레임워크 개체를 만듭니다.
WDF_OBJECT_ATTRIBUTES Attributes;
WDFOBJECT Object;
WDF_OBJECT_ATTRIBUTES_INIT(&Attributes);
status = WdfObjectCreate(
&Attributes,
&Object
);
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 유니버설 |
| 최소 KMDF 버전 | 1.0 |
| 최소 UMDF 버전 | 2.0 |
| 머리글 | wdfobject.h(Wdf.h 포함) |
| 라이브러리 | Wdf01000.sys(KMDF); WUDFx02000.dll(UMDF) |
| IRQL | <=DISPATCH_LEVEL |
| DDI 규정 준수 규칙 | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |