PSCSIWMI_QUERY_REGINFO 콜백 함수(scsiwmi.h)

아티클
08/07/2023

미니포트 드라이버의 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 구조체에 대한 포인터와 Srb-WmiSubFunction>으로 설정된 MinorFunction을 사용하여 ScsiPortWmiDispatchFunction을 호출합니다. MinorFunction이 등록 정보 요청을 나타내는 경우 SCSI 포트 드라이버는 미니포트 드라이버의 HwScsiWmiQueryReginfo 루틴을 호출합니다.

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

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