SCSI_WMILIB_CONTEXT 구조체(scsiwmi.h)

아티클
08/07/2023

SCSI_WMILIB_CONTEXT 구조는 미니포트 드라이버의 데이터 및 이벤트 블록에 대한 등록 정보를 제공하고 미니포트 드라이버의 HwScsiWmiXxx 콜백 루틴에 대한 진입점을 정의합니다.

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

구문

typedef struct _SCSIWMILIB_CONTEXT {
  ULONG                     GuidCount;
  PSCSIWMIGUIDREGINFO       GuidList;
  PSCSIWMI_QUERY_REGINFO    QueryWmiRegInfo;
  PSCSIWMI_QUERY_DATABLOCK  QueryWmiDataBlock;
  PSCSIWMI_SET_DATABLOCK    SetWmiDataBlock;
  PSCSIWMI_SET_DATAITEM     SetWmiDataItem;
  PSCSIWMI_EXECUTE_METHOD   ExecuteWmiMethod;
  PSCSIWMI_FUNCTION_CONTROL WmiFunctionControl;
} SCSI_WMILIB_CONTEXT, *PSCSI_WMILIB_CONTEXT;

멤버

GuidCount

GuidList에서 SCSIWMIGUIDREGINFO 배열의 구조체 수를 지정합니다.

GuidList

각 블록에 대한 등록 정보를 포함하는 GuidCount SCSIWMIGUIDREGINFO 구조체의 배열을 가리킵니다.

QueryWmiRegInfo

WMI를 지원하는 미니포트 드라이버에 필요한 진입점인 드라이버의 HwScsiWmiQueryReginfo 루틴을 가리킵니다.

QueryWmiDataBlock

WMI를 지원하는 미니포트 드라이버에 필요한 진입점인 드라이버의 HwScsiWmiQueryDataBlock 루틴을 가리킵니다.

SetWmiDataBlock

WMI를 지원하는 미니포트 드라이버의 선택적 진입점인 드라이버의 HwScsiWmiSetDataBlock 루틴을 가리킵니다. 미니포트 드라이버가 이 루틴을 구현하지 않는 경우 이 멤버를 NULL로 설정해야 합니다.

SetWmiDataItem

WMI를 지원하는 미니포트 드라이버의 선택적 진입점인 드라이버의 HwScsiWmiSetDataItem 루틴을 가리킵니다. 미니포트 드라이버가 이 루틴을 구현하지 않는 경우 이 멤버를 NULL로 설정해야 합니다.

ExecuteWmiMethod

WMI를 지원하는 미니포트 드라이버의 선택적 진입점인 드라이버의 HwScsiWmiExecuteMethod 루틴을 가리킵니다. 미니포트 드라이버가 이 루틴을 구현하지 않는 경우 이 멤버를 NULL로 설정해야 합니다.

WmiFunctionControl

WMI를 지원하는 미니포트 드라이버의 선택적 진입점인 드라이버의 HwScsiWmiFunctionControl 루틴을 가리킵니다. 미니포트 드라이버가 이 루틴을 구현하지 않는 경우 이 멤버를 NULL로 설정해야 합니다.

설명

WMI를 지원하는 SCSI 미니포트 드라이버는 초기화된 SCSI_WMILIB_CONTEXT 구조체(또는 이러한 구조체에 대한 포인터)를 디바이스 확장에 저장합니다. 각 디바이스 개체가 동일한 데이터 블록 집합을 제공하는 경우 미니포트 드라이버는 여러 디바이스 개체에 대해 동일한 SCSI_WMILIB_CONTEXT 구조를 사용할 수 있습니다.

미니포트 드라이버는 Function 멤버가 SRB_FUNCTION_WMI 설정된 SRB를 받으면 초기화된 SCSI_WMILIB_CONTEXT 구조체에 대한 포인터를 포함하여 요청 매개 변수를 사용하여 ScsiPortWmiDispatchFunction 을 호출합니다. ScsiPortWmiDispatchFunction 은 미니포트 드라이버의 적절한 HwScsiWmiXxx 루틴을 호출하여 요청을 처리합니다.

미니포트 드라이버가 선택적 HwScsiWmiXxx 루틴을 구현하지 않는 경우 포트 드라이버는 호출자에게 적절한 상태 반환합니다.