IRP_MN_CHANGE_SINGLE_INSTANCE

아티클
06/15/2023

WMI를 지원하는 모든 드라이버는 이 IRP를 처리해야 합니다. 드라이버는 WmiSystemControl 을 호출하거나 WMI 요청 처리에 설명된 대로 IRP 자체를 처리 하여 WMI IRP를 처리할 수 있습니다.

드라이버가 WmiSystemControl 을 호출하여 IRP_MN_CHANGE_SINGLE_INSTANCE 요청을 처리하는 경우 WMI는 해당 드라이버의 DpWmiSetDataBlock 루틴을 호출합니다.

주 코드

IRP_MJ_SYSTEM_CONTROL

보낸 경우

WMI는 데이터 블록의 단일 instance 모든 데이터 항목을 변경하기 위해 이 IRP를 보냅니다.

WMI는 임의 스레드 컨텍스트에서 IRQL = PASSIVE_LEVEL 이 IRP를 보냅니다.

입력 매개 변수

Parameters.WMI.ProviderId 는 요청에 응답해야 하는 드라이버의 디바이스 개체를 가리킵니다. 이 포인터는 IRP의 드라이버 I/O 스택 위치에 있습니다.

Parameters.WMI.DataPath는 변경할 instance 연결된 데이터 블록을 식별하는 GUID를 가리킵니다.

Parameters.WMI.BufferSize 는 Parameters.WMI.Buffer에서 페이지가 없는 버퍼의 크기를 나타냅니다.

Parameters.WMI.Buffer는 instance 식별하고 새 데이터 값을 지정하는 WNODE_SINGLE_INSTANCE 구조를 가리킵니다.

출력 매개 변수

없음

I/O 상태 블록

드라이버가 WmiSystemControl을 호출하여 IRP를 처리하는 경우 WMI는 I/O 상태 블록에서 Irp-IoStatus.Status> 및 Irp-IoStatus.Information>를 설정합니다.

그렇지 않으면 드라이버는 Irp-IoStatus.Status>를 STATUS_SUCCESS 또는 다음과 같은 적절한 오류 상태 설정합니다.

STATUS_WMI_INSTANCE_NOT_FOUND

STATUS_WMI_GUID_NOT_FOUND

STATUS_WMI_READ_ONLY

STATUS_WMI_SET_FAILURE

성공하면 드라이버는 Irp-IoStatus.Information>를 0으로 설정합니다.

작업

드라이버가 WmiSystemControl을 호출하여 WMI IRP를 처리하는 경우 해당 루틴은 드라이버의 DpWmiSetDataBlock 루틴을 호출하거나 드라이버가 루틴을 정의하지 않으면 STATUS_WMI_READ_ONLY 반환합니다.

드라이버가 IRP_MN_CHANGE_SINGLE_INSTANCE 요청 자체를 처리하는 경우 Parameters.WMI.ProviderId 의 디바이스 개체 포인터가 IoWMIRegistrationControl 호출에서 드라이버가 전달한 포인터와 일치하는 경우에만 처리합니다. 그렇지 않으면 드라이버가 다음 하위 드라이버에 요청을 전달해야 합니다.

드라이버가 요청을 처리하는 경우 먼저 Parameters.WMI.DataPath의 GUID를 검사 드라이버에서 지원하는 데이터 블록을 식별하는지 여부를 확인해야 합니다. 그렇지 않은 경우 드라이버는 IRP에 실패하고 STATUS_WMI_GUID_NOT_FOUND 반환해야 합니다.

드라이버가 데이터 블록을 지원하는 경우 다음과 같이 instance 이름에 대해 Parameters.WMI.Buffer에서 받은 WNODE_SINGLE_INSTANCE 구조를 검사 합니다.

WNODE_FLAG_STATIC_INSTANCE_NAMES WnodeHeader.Flags에서 설정된 경우 드라이버는 InstanceIndex를 해당 블록에 대한 드라이버의 정적 instance 이름 목록에 대한 인덱스로 사용합니다. WMI는 블록을 등록할 때 드라이버가 제공한 등록 데이터에서 인덱스를 가져옵니다.
WnodeHeader.Flags에서 WNODE_FLAG_STATIC_INSTANCE_NAMES 명확하면 드라이버는 OffsetInstanceName의 오프셋을 사용하여 입력 WNODE_SINGLE_INSTANCE instance 이름 문자열을 찾습니다. OffsetInstanceName은 구조체의 시작 부분에서 usHORT 크기의 instance usHORT 크기 길이(문자가 아님)까지의 오프셋으로, 있는 경우 종료 null을 포함하고 유니코드의 instance 이름 문자열을 포함합니다.

드라이버는 모든 입력 값의 유효성을 검사해야 합니다. 특히 드라이버는 IRP 요청 자체를 처리하는 경우 다음을 수행해야 합니다.

정적 이름의 경우 WNODE_SINGLE_INSTANCE 구조의 InstanceIndex 멤버가 드라이버가 데이터 블록에 대해 지원하는 instance 인덱스 범위 내에 있는지 확인합니다.
동적 이름의 경우 instance 이름 문자열이 드라이버에서 지원하는 데이터 블록 instance 식별하는지 확인합니다.
WNODE_SINGLE_INSTANCE 구조의 DataBlockOffset 및 SizeDataBlock 멤버가 데이터 항목 사이에 존재하는 패딩을 포함하여 유효한 크기의 데이터 블록을 설명하고 버퍼의 내용이 데이터 블록에 유효한지 확인합니다.
지정된 데이터 블록이 드라이버가 호출자 시작 수정을 허용하는 블록인지 확인합니다. 즉, 드라이버는 읽기 전용으로 의도한 데이터 블록에 대한 수정을 허용해서는 안 됩니다.

스레드 컨텍스트가 시작하는 사용자 모드 애플리케이션의 컨텍스트라고 가정하지 마세요. 상위 수준 드라이버가 변경되었을 수 있습니다.

드라이버가 지정된 instance 찾을 수 없는 경우 IRP에 실패하고 STATUS_WMI_INSTANCE_NOT_FOUND 반환해야 합니다. instance 동적 instance 이름이 있는 경우 이 상태 드라이버가 instance 지원하지 않음을 나타냅니다. 따라서 WMI는 다른 데이터 공급자를 계속 쿼리하고 다른 공급자가 instance 찾지만 다른 이유로 요청을 처리할 수 없는 경우 데이터 소비자에게 적절한 오류를 반환할 수 있습니다.

드라이버가 instance 찾아 요청을 처리할 수 있는 경우 instance 쓰기 가능한 데이터 항목을 WNODE_SINGLE_INSTANCE 구조의 값으로 설정하므로 읽기 전용 항목은 변경되지 않습니다. 전체 데이터 블록이 읽기 전용인 경우 드라이버는 IRP에 실패하고 STATUS_WMI_READ_ONLY 반환해야 합니다.

instance 유효하지만 드라이버가 요청을 처리할 수 없는 경우 적절한 오류 상태 반환할 수 있습니다.