PSCSIWMI_QUERY_REGINFO 콜백 함수(scsiwmi.h)

미니포트 드라이버의 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 반환합니다.

설명

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

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

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

요구 사항

대상 플랫폼	데스크톱
헤더	scsiwmi.h(Scsiwmi.h 포함)

참고 항목

SCSIWMI_REQUEST_CONTEXT

SCSI_WMILIB_CONTEXT

ScsiPortWmiDispatchFunction