PSCSIWMI_QUERY_REGINFO 콜백 함수(scsiwmi.h)

아티클
02/07/2025

미니포트 드라이버의 HwScsiWmiQueryReginfo 루틴은 SCSI 포트 드라이버가 미니포트 드라이버를 대신하여 등록할 데이터 및 이벤트 블록에 대한 정보를 얻기 위해 호출됩니다. 이 루틴은 필수입니다.

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

통사론

PSCSIWMI_QUERY_REGINFO PscsiwmiQueryReginfo;

UCHAR PscsiwmiQueryReginfo(
  [in]  PVOID DeviceContext,
  [in]  PSCSIWMI_REQUEST_CONTEXT RequestContext,
  [out] PWSTR *MofResourceName
)
{...}

매개 변수

[in] DeviceContext

ScsiPortWmiDispatchFunction전달된 미니포트 드라이버 정의 컨텍스트 값을 가리킵니다.

[in] RequestContext

미니포트 드라이버가 ScsiPortWmiDispatchFunction전달한 SCSIWMI_REQUEST_CONTEXT 구조를 가리킵니다.

[out] MofResourceName

미니포트 드라이버의 이진 이미지 파일에 연결된 MOF 리소스의 이름을 나타내는 null종료된 유니코드 문자열을 가리킵니다. 이 문자열은 미니포트 드라이버에서 상수로 선언할 수 있습니다. 미니포트 드라이버에 MOF 리소스가 연결되어 있지 않으면 mofResourceName NULL 설정해야 합니다.

반환 값

HwScsiWmiQueryReginfo 항상 SRB_STATUS_SUCCESS 반환합니다.

발언

미니포트 드라이버는 Function 멤버가 SRB_FUNCTION_WMI 설정된 SRB를 받으면 초기화된 SCSI_WMILIB_CONTEXT 구조에 대한 포인터를 사용하여 ScsiPortWmiDispatchFunction 호출하고 MinorFunction Srb->WmiSubFunction 설정합니다. MinorFunction 등록 정보 요청을 나타내는 경우 SCSI 포트 드라이버는 미니포트 드라이버의 HwScsiWmiQueryReginfo 루틴을 호출합니다.

미니포트 드라이버는 개별 블록에 대한 신규 또는 업데이트된 등록 정보를 제공하거나 제거할 블록을 나타내며, SCSI_WMILIB_CONTEXT 구조에서 ScsiPortWmiDispatchFunction전달합니다. 미니포트 드라이버의 HwScsiWmiQueryReginfo 루틴은 MOF 리소스 이름에 대한 포인터를 제공합니다.

미니포트 드라이버는 SRB를 보류하거나 차단하지 않아야 합니다. 미니포트 드라이버는 HwScsiWmiQueryReginfo 루틴에서 ScsiPortWmiPostProcess 또는 ScsiPortNotification 호출해서는 안 됩니다.