WdfDeviceInitSetRequestAttributes 함수(wdfdevice.h)

  • 아티클

[KMDF 및 UMDF에 적용]

WdfDeviceInitSetRequestAttributes 메서드는 프레임워크가 디바이스의 I/O 큐에서 드라이버에 제공하는 모든 프레임워크 요청 개체에 사용할 개체 특성을 설정합니다.

구문

void WdfDeviceInitSetRequestAttributes(
  [in] PWDFDEVICE_INIT        DeviceInit,
  [in] PWDF_OBJECT_ATTRIBUTES RequestAttributes
);

매개 변수

[in] DeviceInit

WDFDEVICE_INIT 구조체에 대한 호출자 제공 포인터입니다.

[in] RequestAttributes

디바이스의 요청 개체에 대한 특성을 포함하는 호출자가 할당한 WDF_OBJECT_ATTRIBUTES 구조체에 대한 포인터입니다.

반환 값

없음

설명

드라이버는 WdfDeviceInitSetRequestAttributes 를 호출하여 프레임워크가 드라이버에 대해 만드는 요청 개체에 할당할 개체 컨텍스트 공간을 지정할 수 있습니다. 이 컨텍스트 공간에 대한 자세한 내용은 요청 개체 컨텍스트 사용을 참조하세요.

프레임워크는 드라이버가 WdfRequestCreate 또는 WdfRequestCreateFromIrp을 호출할 때 만드는 요청 개체에 대해 지정된 개체 특성을 사용하지 않습니다.

드라이버가 WdfDeviceCreate를 호출하기 전에 EvtDriverDeviceAdd 콜백 함수 내에서 WdfDeviceInitSetRequestAttributes를 호출해야 합니다. 자세한 내용은 프레임워크 디바이스 개체 만들기를 참조하세요.

예제

다음 코드 예제에서는 WDF_OBJECT_ATTRIBUTES 구조를 초기화하고 WdfDeviceInitSetRequestAttributes를 호출합니다.

typedef struct _REQUEST_CONTEXT {
  ULONG_PTR  Information;
} REQUEST_CONTEXT, *PREQUEST_CONTEXT;
WDF_OBJECT_ATTRIBUTES  attributes;

WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(
                                        &attributes,
                                        REQUEST_CONTEXT
                                        );
WdfDeviceInitSetRequestAttributes(
                                  DeviceInit,
                                  &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), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

추가 정보

EvtDriverDeviceAdd