ScsiPortWmiGetInstanceName 함수(scsiwmi.h)
ScsiPortWmiGetInstanceName 루틴은 표시된 WMI(Windows Management Instrumentation) SCSI SRB(요청 블록)와 연결된 인스턴스 이름에 대한 포인터를 반환합니다.
통사론
PWCHAR ScsiPortWmiGetInstanceName(
[in] PSCSIWMI_REQUEST_CONTEXT RequestContext
);
매개 변수
[in] RequestContext
WMI SRB에 대한 요청 컨텍스트를 포함하는 형식 SCSIWMI_REQUEST_CONTEXT 구조체에 대한 포인터입니다.
반환 값
표시된 SRB와 연결된 인스턴스 이름을 포함하는 계산된 문자열에 대한 포인터입니다. SRB 형식이 인스턴스 이름을 사용하지 않는 형식인 경우 ScsiPortWmiGetInstanceNameNULL반환합니다.
발언
RequestContext 매개 변수는 WMI(Windows Management Instrumentation) SRB(SCSI 요청 블록)와 연결된 정보를 포함하는 요청 컨텍스트 구조(SCSIWMI_REQUEST_CONTEXT)를 가리킵니다. 요청 컨텍스트 구조는 WMI 시스템에서 사용자 모드 데이터 소비자와 커널 모드 데이터 공급자(예: 드라이버) 간에 데이터를 전달하는 데 사용하는 WMI WNODE_XXX 구조 중 하나를 포함합니다.
요청 컨텍스트에 포함된 WNODE_XXX 구조에는 WMI SRB와 연결된 인스턴스 이름이 포함됩니다. 미니포트 드라이버는 ScsiPortWmiGetInstanceName 호출하여 요청 컨텍스트에서 이 인스턴스 이름을 추출합니다.
요청 컨텍스트에 할당된 메모리는 미니포트 드라이버가 ScsiPortWmiPostProcess호출하고 ScsiPortWmiPostProcess 최종 SRB 상태 및 버퍼 크기를 반환할 때까지 유효해야 합니다. SRB가 보류될 수 있는 경우 요청 컨텍스트에 대한 메모리는 SRB 확장에서 할당되어야 합니다. SRB가 보류할 수 없는 경우 범위를 벗어나지 않는 스택 프레임에서 메모리를 할당할 수 있습니다.
요구 사항
| 요구 | 값 |
|---|---|
| 대상 플랫폼 | 바탕 화면 |
| 헤더 | scsiwmi.h(Miniport.h, Scsi.h 포함) |