WdfWmiInstanceRegister 함수(wdfwmi.h)

  • 아티클

[KMDF에만 적용]

WdfWmiInstanceRegister 메서드는 WMI 데이터 공급자의 지정된 instance 시스템의 WMI 서비스에 등록합니다.

구문

NTSTATUS WdfWmiInstanceRegister(
  [in] WDFWMIINSTANCE WmiInstance
);

매개 변수

[in] WmiInstance

드라이버가 WdfWmiInstanceCreate에 대한 이전 호출에서 가져온 WMI instance 개체에 대한 핸들입니다.

반환 값

WdfWmiInstanceRegister 는 작업이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 이 메서드는 다음 값 중 하나를 반환할 수 있습니다.

반환 코드 설명
STATUS_INVALID_DEVICE_REQUEST
 지정된 WMI instance 이미 등록되어 있습니다.
 

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

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

설명

공급자 인스턴스는 등록될 때까지 WMI 클라이언트에서 사용할 수 없습니다. 드라이버는 WdfWmiInstanceRegister를 호출하거나 instance WDF_WMI_INSTANCE_CONFIG 구조체의 Register 멤버를 TRUE로 설정해야 합니다.

WdfWmiInstanceRegister 메서드에 대한 자세한 내용은 공급자 인스턴스 등록을 참조하세요. WMI에 대한 자세한 내용은 Framework-Based 드라이버에서 WMI 지원을 참조하세요.

WdfWmiInstanceRegister는 IRQL = PASSIVE_LEVEL 호출되고 IRQL PASSIVE_LEVEL 호출 > 되는 경우 비동기적으로 공급자를 동기적으로(즉, 반환하기 전에) instance 등록합니다.

예제

다음 코드 예제에서는 WMI 데이터 공급자의 지정된 instance 시스템의 WMI 서비스에 등록합니다.

NTSTATUS  status;

status = WdfWmiInstanceRegister(wmiInstance);

요구 사항

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

추가 정보

WDF_WMI_INSTANCE_CONFIG

WdfWmiInstanceCreate

WdfWmiInstanceDeregister