다음을 통해 공유

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)