SCSIWMIGUIDREGINFO 구조체(scsiwmi.h)

아티클
03/05/2024

SCSIWMIGUIDREGINFO 구조체에는 SCSI 미니포트 드라이버에서 지원하는 지정된 데이터 또는 이벤트 블록에 대한 정보가 포함됩니다.

참고 SCSI 포트 드라이버 및 SCSI 미니포트 드라이버 모델은 나중에 변경되거나 사용할 수 없습니다. 대신 Storport 드라이버 및 Storport 미니포트 드라이버 모델을 사용하는 것이 좋습니다.

구문

typedef struct {
  LPCGUID Guid;
  ULONG   InstanceCount;
  ULONG   Flags;
} SCSIWMIGUIDREGINFO, *PSCSIWMIGUIDREGINFO;

멤버

Guid

블록을 식별하는 GUID를 가리킵니다.

InstanceCount

블록에 대해 정의된 인스턴스 수를 지정합니다.

Flags

블록의 특성을 나타냅니다. SCSI 포트 드라이버는 미니포트 드라이버를 대신하여 다음 WMIREG_FLAG_XXX 를 제외한 모든 것을 설정합니다. 미니포트 드라이버는 다음 플래그 중 하나 이상을 설정할 수 있습니다.

WMIREG_FLAG_EVENT_ONLY_GUID

블록은 이벤트로만 사용하거나 사용하지 않도록 설정할 수 있으며 쿼리하거나 설정할 수 없습니다. 이 플래그가 명확하면 블록을 쿼리하거나 설정할 수도 있습니다.

WMIREG_FLAG_EXPENSIVE

데이터 소비자가 데이터 블록을 처음 열 때 포트 드라이버가 enable-collection SRB를 보내도록 요청하고 마지막 데이터 소비자가 데이터 블록을 닫을 때 SRB를 사용하지 않도록 설정합니다. 이러한 데이터를 수집하는 것이 성능에 영향을 미치는 경우 권장됩니다. 미니포트 드라이버는 데이터 소비자가 블록을 열어 명시적으로 요청할 때까지 데이터를 수집할 필요가 없습니다.

WMIREG_FLAG_REMOVE_GUID

설정된 경우 이전에 등록된 블록에 대한 지원을 제거합니다.

설명

미니포트 드라이버는 ScsiPortWmiDispatchFunction의 WmiLibInfo 매개 변수에 SCSIWMIREGGUID 배열이 포함된 SCSI_WMILIB_CONTEXT 포인터를 전달합니다. 미니포트 드라이버는 ScsiPortWmiDispatchFunction을 호출할 때마다 이 정보를 전달합니다. 배열의 각 SCSIWMIREGGUID 구조체는 미니포트 드라이버의 데이터 또는 이벤트 블록 중 하나를 나타냅니다.

미니포트 드라이버의 SCSIWMIREGGUID 배열에는 디바이스 유형에 대해 wmicore.mof 에 정의된 표준 데이터 블록이 포함되어야 하며 미니포트 드라이버 정의 데이터 및 이벤트 블록이 포함될 수 있습니다. 미니포트 드라이버는 MOF 파일에서 사용자 지정 데이터 및 이벤트 블록을 정의합니다. 이 파일은 미니포트 드라이버의 이진 이미지에 연결된 리소스로 컴파일되고 미니포트 드라이버 HwScsiWmiQueryReginfo 루틴의 MofResourceName 매개 변수에 지정됩니다.

블록 정의에 대한 자세한 내용은 Windows Management Instrumentation을 참조하세요.