ScsiPortWmiGetInstanceName 함수(scsiwmi.h)

ScsiPortWmiGetInstanceName 루틴은 표시된 WMI(Windows Management Instrumentation) SCSI 요청 블록(SRB)과 연결된 instance 이름에 대한 포인터를 반환합니다.

구문

PWCHAR ScsiPortWmiGetInstanceName(
  [in] PSCSIWMI_REQUEST_CONTEXT RequestContext
);

매개 변수

[in] RequestContext

WMI SRB에 대한 요청 컨텍스트를 포함하는 형식 SCSIWMI_REQUEST_CONTEXT 구조체에 대한 포인터입니다.

반환 값

표시된 SRB와 연결된 instance 이름을 포함하는 계산된 문자열에 대한 포인터입니다. SRB 형식이 instance 이름을 사용하지 않는 형식이면 ScsiPortWmiGetInstanceName은 NULL을 반환합니다.

설명

RequestContext 매개 변수는 WMI(Windows Management Instrumentation) SRB(SCSI 요청 블록)와 연결된 정보를 포함하는 요청 컨텍스트 구조인 SCSIWMI_REQUEST_CONTEXT 가리킵니다. 요청 컨텍스트 구조는 WMI 시스템에서 사용자 모드 데이터 소비자와 드라이버와 같은 커널 모드 데이터 공급자 간에 데이터를 전달하는 데 사용하는 WMI WNODE_XXX 구조 중 하나를 포함합니다.

요청 컨텍스트에 포함된 WNODE_XXX 구조체에는 WMI SRB와 연결된 instance 이름이 있습니다. 미니포트 드라이버는 ScsiPortWmiGetInstanceName을 호출하여 요청 컨텍스트에서 이 instance 이름을 추출합니다.

요청 컨텍스트에 할당된 메모리는 미니포트 드라이버가 ScsiPortWmiPostProcess를 호출하고 ScsiPortWmiPostProcess가 최종 SRB 상태 및 버퍼 크기를 반환할 때까지 유효해야 합니다. SRB가 보류될 수 있는 경우 요청 컨텍스트에 대한 메모리는 SRB 확장에서 할당되어야 합니다. SRB가 보류할 수 없는 경우 scope 나가지 않는 스택 프레임에서 메모리를 할당할 수 있습니다.

요구 사항

추가 정보

SCSIWMI_REQUEST_CONTEXT

WNODE_ALL_DATA

WNODE_SINGLE_INSTANCE