WdfDeviceAssignMofResourceName 함수(wdfdevice.h)

  • 아티클

[KMDF에만 적용]

WdfDeviceAssignMofResourceName 메서드는 지정된 디바이스에 대한 MOF 리소스 이름을 등록합니다.

구문

NTSTATUS WdfDeviceAssignMofResourceName(
  [in] WDFDEVICE        Device,
  [in] PCUNICODE_STRING MofResourceName
);

매개 변수

[in] Device

프레임워크 디바이스 개체에 대한 핸들입니다.

[in] MofResourceName

MOF 리소스의 이름을 지정하는 UNICODE_STRING 구조체에 대한 포인터입니다.

반환 값

작업이 성공하면 WdfDeviceAssignMofResourceName 은 STATUS_SUCCESS 반환합니다. 추가 반환 값은 다음과 같습니다.

반환 코드 설명
STATUS_INVALID_DEVICE_REQUEST
 드라이버는 이미 WdfDeviceAssignMofResourceName을 호출했습니다.
STATUS_INSUFFICIENT_RESOURCES
 사용 가능한 메모리가 부족합니다.
 

메서드는 다른 NTSTATUS 값을 반환할 수 있습니다.

드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다.

설명

WMI를 지원하는 MOF 파일을 제공하는 드라이버는 일반적으로 EvtDriverDeviceAdd 또는 EvtDevicePrepareHardware 콜백 함수 내에서 WdfDeviceAssignMofResourceName을 호출해야 합니다. MOF 리소스 이름은 드라이버가 RC(리소스 스크립트) 파일의 MofResource 문에 지정하는 파일 이름입니다. MOF 리소스 이름을 지정하는 방법에 대한 자세한 내용은 드라이버의 MOF 파일 컴파일을 참조하세요.

버스에서 디바이스를 열거하는 드라이버는 부모 디바이스에 대해WdfDeviceAssignMofResourceName을 호출할 수 있으며 프레임워크는 자식 디바이스에 대해 부모의 MOF 리소스 이름을 사용합니다.

WMI에 대한 자세한 내용은 Framework-Based 드라이버에서 WMI 지원을 참조하세요.

예제

다음 코드 예제에서는 MOF 리소스 이름을 나타내는 유니코드 문자열을 선언한 다음 이름을 등록합니다.

NTSTATUS  status;
DECLARE_CONST_UNICODE_STRING(mofRsrcName, MOFRESOURCENAME);

status = WdfDeviceAssignMofResourceName(
                                        Device,
                                        &mofRsrcName
                                        );
if (!NT_SUCCESS(status)) {
    return status;
}

요구 사항

요구 사항 값
대상 플랫폼 유니버설
최소 KMDF 버전 1.0
머리글 wdfdevice.h(Wdf.h 포함)
라이브러리 Wdf01000.sys(프레임워크 라이브러리 버전 관리 참조)
IRQL PASSIVE_LEVEL
DDI 규정 준수 규칙 DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)