WdfDeviceInitSetFileObjectConfig 함수(wdfdevice.h)

[KMDF 및 UMDF에 적용]

WdfDeviceInitSetFileObjectConfig 메서드는 이벤트 콜백 함수를 등록하고 드라이버의 프레임워크 파일 개체에 대한 구성 정보를 설정합니다.

구문

void WdfDeviceInitSetFileObjectConfig(
  [in]           PWDFDEVICE_INIT        DeviceInit,
  [in]           PWDF_FILEOBJECT_CONFIG FileObjectConfig,
  [in, optional] PWDF_OBJECT_ATTRIBUTES FileObjectAttributes
);

매개 변수

[in] DeviceInit

WDFDEVICE_INIT 구조체에 대한 포인터입니다.

[in] FileObjectConfig

호출자가 할당한 WDF_FILEOBJECT_CONFIG 구조체에 대한 포인터입니다.

[in, optional] FileObjectAttributes

드라이버의 프레임워크 파일 개체에 대한 드라이버 제공 개체 특성을 포함하는 호출자가 할당한 WDF_OBJECT_ATTRIBUTES 구조체에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 WDF_NO_OBJECT_ATTRIBUTES 수 있습니다.

반환 값

없음

설명

드라이버가 WdfDeviceInitSetFileObjectConfig를 호출하는 경우 WdfDeviceCreate를 호출하기 전에 호출해야 합니다.

기본적으로 각 프레임워크 파일 개체는 부모 디바이스 개체에서 동기화 scope 및 실행 수준을 상속합니다. 부모 디바이스 개체의 동기화 scope 및 실행 수준이 WdfSynchronizationScopeNone 및 WdfExecutionLevelPassive가 아닌 경우 드라이버는 FileObjectAttributes 매개 변수가 지정하는 WDF_OBJECT_ATTRIBUTES 구조에서 WdfSynchronizationScopeNone 및 WdfExecutionLevelPassive 값을 설정해야 합니다. 그렇지 않으면 WdfDeviceCreate는 코드에 오류 상태 반환합니다. 동기화 scope 및 실행 수준에 대한 자세한 내용은 자동 동기화 사용을 참조하세요.

WdfDeviceCreate를 호출하는 방법에 대한 자세한 내용은 프레임워크 디바이스 개체 만들기를 참조하세요.

프레임워크 파일 개체에 대한 자세한 내용은 프레임워크 파일 개체를 참조하세요.

예제

다음 코드 예제에서는 WDF_OBJECT_ATTRIBUTES 구조체 및 WDF_FILEOBJECT_CONFIG 구조를 초기화한 다음 WdfDeviceInitSetFileObjectConfig를 호출합니다.

WDF_OBJECT_ATTRIBUTES  attributes;

WDF_OBJECT_ATTRIBUTES_INIT(&attributes);
attributes.SynchronizationScope = WdfSynchronizationScopeNone;
WDF_FILEOBJECT_CONFIG_INIT(
                           &deviceConfig,
                           MyEvtDeviceFileCreate,
                           MyEvtFileClose,
                           WDF_NO_EVENT_CALLBACK // No cleanup callback function
                           );
WdfDeviceInitSetFileObjectConfig(
                                 DeviceInit,
                                 &deviceConfig,
                                 &attributes
                                 );

요구 사항

요구 사항	값
대상 플랫폼	유니버설
최소 KMDF 버전	1.0
최소 UMDF 버전	2.0
머리글	wdfdevice.h(Wdf.h 포함)
라이브러리	Wdf01000.sys(KMDF); WUDFx02000.dll(UMDF)
IRQL	<= DISPATCH_LEVEL
DDI 규정 준수 규칙	ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), FileObjectConfigured(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

추가 정보

WDF_FILEOBJECT_CONFIG_INIT

WDF_OBJECT_ATTRIBUTES_INIT

WdfFdoInitSetEventCallbacks

WdfPdoInitSetEventCallbacks