VIRTUAL_HW_FIND_ADAPTER 콜백 함수(storport.h)

아티클
08/07/2023

Storport 가상 미니포트는 VIRTUAL_HW_FIND_ADAPTER 루틴에 제공된 구성 정보를 사용하여 자신을 추가로 초기화합니다.

구문

VIRTUAL_HW_FIND_ADAPTER VirtualHwFindAdapter;

ULONG VirtualHwFindAdapter(
  PVOID DeviceExtension,
  PVOID HwContext,
  PVOID BusInformation,
  PVOID LowerDevice,
  PCHAR ArgumentString,
  PPORT_CONFIGURATION_INFORMATION ConfigInfo,
  PBOOLEAN Again
)
{...}

매개 변수

DeviceExtension

미니포트 드라이버의 어댑터별 페이징되지 않은 스토리지 영역에 대한 포인터입니다. 운영 체제별 포트 드라이버는 미니포트의 VIRTUAL_HW_FIND_ADAPTER 루틴을 호출하기 전에 메모리를 할당하고 이 확장을 0으로 초기화합니다.

HwContext

디바이스 스택의 PDO에 대한 포인터입니다. HBA 자체는 FDO입니다. 미니포트 드라이버가 물리적 하드웨어를 제어하는 경우 PDO는 Pci.sys 드라이버에 속할 수 있습니다. 그러나 가상 미니포트 드라이버의 경우 PDO는 PnP 관리자에 속합니다.

BusInformation

미니포트의 FDO(기능 디바이스 개체)에 대한 포인터입니다.

LowerDevice

미니포트의 FDO로 제어되는 디바이스 개체에 대한 포인터입니다.

ArgumentString

null로 끝나는 ASCII 문자열에 대한 포인터입니다. 이 문자열은 제공된 경우 기본 매개 변수와 같은 레지스트리의 디바이스 정보를 포함합니다.

ConfigInfo

PORT_CONFIGURATION_INFORMATION 구조체에 대한 포인터입니다. 포트 드라이버는 미니포트 드라이버의 DriverEntry 가 VIRTUAL_HW_INITIALIZATION_DATA 설정한 값과 같은 알려진 구성 정보를 사용하여 이 구조를 초기화합니다. VIRTUAL_HW_FIND_ADAPTER 제공된 정보를 사용하여 설명하는 가상 HBA가 미니포트 드라이버에서 지원하는 가상 HBA인지 확인해야 합니다. 이 경우 VIRTUAL_HW_FIND_ADAPTER HBA를 초기화하고 구성하고 누락된 구성 정보를 채웁니다. 가능한 경우 미니포트 드라이버는 운영 체제 종속 포트 드라이버가 미니포트 드라이버의 DriverEntry 루틴에서 제공하지 않은 추가 구성 정보를 제공할 수 없는 경우 지원하는 각 HBA 유형에 대한 기본 구성 값을 가져야 합니다.

Again

사용되지 않습니다.

반환 값

VIRTUAL_HW_FIND_ADAPTER 다음 상태 값 중 하나를 반환해야 합니다.

반환 코드	설명
SP_RETURN_FOUND	지원되는 HBA가 발견되었으며 HBA 관련 구성 정보가 성공적으로 결정되어 PORT_CONFIGURATION_INFORMATION 구조에서 설정되었습니다.
SP_RETURN_ERROR	HBA가 발견되었지만 구성 정보를 가져올 때 오류가 발생했습니다. 가능하면 ScsiPortLogError를 사용하여 이러한 오류를 기록해야 합니다.
SP_RETURN_BAD_CONFIG	제공된 구성 정보가 어댑터에 유효하지 않습니다.
SP_RETURN_NOT_FOUND	제공된 구성 정보에 대해 지원되는 HBA를 찾을 수 없습니다.

설명

구성 정보 구조의 VirtualDevice 필드는 TRUE로 설정해야 합니다. 필요에 따라 다른 필드를 설정할 수 있습니다.

포트 드라이버는 PASSIVE_LEVEL Storport 가상 미니포트의 VIRTUAL_HW_FIND_ADAPTER 호출합니다.

VirtualHwStorFindAdapter 이름은 실제 루틴 이름의 자리 표시자 텍스트입니다. 이 루틴의 실제 프로토타입은 다음과 같이 Srb.h 에 정의됩니다.

typedef
ULONG
VIRTUAL_HW_FIND_ADAPTER (
  _In_ PVOID  DeviceExtension,
  _In_ PVOID  HwContext,
  _In_ PVOID  BusInformation,
  _In_ PVOID  LowerDevice,
  _In_ PCHAR  ArgumentString,
  _Inout_ PPORT_CONFIGURATION_INFORMATION  ConfigInfo,
  _Out_ PBOOLEAN Again
  );

예제

VIRTUAL_HW_FIND_ADAPTER 콜백 함수를 정의하려면 먼저 정의하려는 콜백 함수의 형식을 식별하는 함수 선언을 제공해야 합니다. Windows는 드라이버에 대한 콜백 함수 형식 집합을 제공합니다. 콜백 함수 형식을 사용하여 함수를 선언하면 드라이버에 대한 코드 분석, SDV( 정적 드라이버 검증 도구 ) 및 기타 확인 도구에서 오류를 찾을 수 있으며 Windows 운영 체제용 드라이버를 작성하기 위한 요구 사항입니다.

예를 들어 MyVirtualHwFindAdapter라는 VIRTUAL_HW_FIND_ADAPTER 콜백 루틴을 정의하려면 다음 코드 예제와 같이 VIRTUAL_HW_FIND_ADAPTER 형식을 사용합니다.

VIRTUAL_HW_FIND_ADAPTER MyVirtualHwFindAdapter;

그런 다음 다음과 같이 콜백 루틴을 구현합니다.

_Use_decl_annotations_
ULONG
MyVirtualHwFindAdapter (
  _In_ PVOID  DeviceExtension,
  _In_ PVOID  HwContext,
  _In_ PVOID  BusInformation,
  _In_ PVOID  LowerDevice,
  _In_ PCHAR  ArgumentString,
  _Inout_ PPORT_CONFIGURATION_INFORMATION  ConfigInfo,
  _Out_ PBOOLEAN Again
  );
  {
      ...
  }

VIRTUAL_HW_FIND_ADAPTER 함수 형식은 Storport.h 헤더 파일에 정의되어 있습니다. 코드 분석 도구를 실행할 때 오류를 보다 정확하게 식별하려면 함수 정의에 Use_decl_annotations 주석을 추가해야 합니다. Use_decl_annotations 주석은 헤더 파일의 VIRTUAL_HW_FIND_ADAPTER 함수 형식에 적용되는 주석이 사용되도록 합니다. 함수 선언 요구 사항에 대한 자세한 내용은 Storport 드라이버에 함수 역할 형식을 사용하여 함수 선언을 참조하세요. Use_decl_annotations 대한 자세한 내용은 함수 동작 주석 지정을 참조하세요.