피드백

WNODE_SINGLE_INSTANCE 구조체(wmistr.h)

  • 아티클
  • 읽는 데 2분 걸림

WNODE_SINGLE_INSTANCE 구조에는 데이터 블록의 한 인스턴스에 있는 모든 데이터 항목에 대한 값이 포함됩니다.

구문

typedef struct tagWNODE_SINGLE_INSTANCE {
  struct _WNODE_HEADER WnodeHeader;
  ULONG                OffsetInstanceName;
  ULONG                InstanceIndex;
  ULONG                DataBlockOffset;
  ULONG                SizeDataBlock;
  UCHAR                VariableData[];
} WNODE_SINGLE_INSTANCE, *PWNODE_SINGLE_INSTANCE;

구성원

WnodeHeader

버퍼 크기, 요청과 연결된 데이터 블록을 나타내는 GUID, 전달되거나 반환되는 WNODE_XXX 데이터에 대한 정보를 제공하는 플래그 등 모든 WNODE_XXX 구조체에 공통적인 정보를 포함하는 WNODE_HEADER 구조체입니다.

OffsetInstanceName

이 구조체의 시작부터 USHORT 경계에 맞춰진 이 인스턴스의 동적 인스턴스 이름까지의 오프셋을 나타냅니다. 이 멤버는 WnodeHeader.Flags에서 WNODE_FLAG_STATIC_INSTANCE_NAMES 명확한 경우에만 유효합니다. 데이터 블록이 정적 인스턴스 이름으로 등록된 경우 WMI는 OffsetInstanceName을 무시합니다.

InstanceIndex

정적 인스턴스 이름으로 등록된 인스턴스의 인덱스입니다. 이 멤버는 WNODE_FLAG_STATIC_INSTANCE_NAMES WnodeHeader.Flags에 설정된 경우에만 유효합니다. 데이터 블록이 동적 인스턴스 이름으로 등록된 경우 WMI는 InstanceIndex를 무시합니다.

DataBlockOffset

이 구조체의 시작부터 인스턴스의 시작 부분까지의 오프셋을 나타냅니다.

SizeDataBlock

이 인스턴스의 데이터 블록 크기를 나타냅니다.

VariableData

동적 인스턴스 이름(있는 경우) 및 인스턴스가 8바이트 경계에서 시작되도록 패딩 및 반환할 데이터 블록의 인스턴스를 포함한 추가 데이터를 포함합니다.

설명

WMI는 IRP_MN_CHANGE_SINGLE_INSTANCE 요청과 함께 WNODE_SINGLE_INSTANCE 전달하여 데이터 블록 인스턴스에서 읽기/쓰기 데이터 항목을 설정합니다. 드라이버는 인스턴스의 읽기 전용 데이터 항목에 대해 전달된 값을 무시할 수 있습니다.

드라이버는 IRP_MN_QUERY_SINGLE_INSTANCE 요청에 대한 응답으로 또는 단일 인스턴스로 구성된 이벤트를 생성하기 위해 WNODE_SINGLE_INSTANCE 채웁니다.

요구 사항

   
헤더 wmistr.h(Wmistr.h 포함)

참고 항목

WNODE_EVENT_ITEM

WNODE_HEADER