SPB_CONNECTION_PARAMETERS 구조체(spbcx.h)

아티클
02/27/2024

SPB_CONNECTION_PARAMETERS 구조에는 간단한 주변 버스의 대상 디바이스에 대한 연결 매개 변수가 포함되어 있습니다.

구문

typedef struct _SPB_CONNECTION_PARAMETERS {
  USHORT Size;
  PCWSTR ConnectionTag;
  PVOID  ConnectionParameters;
} SPB_CONNECTION_PARAMETERS, *PSPB_CONNECTION_PARAMETERS;

멤버

Size

이 구조체의 크기(바이트)입니다. SpbTargetGetConnectionParameters 메서드는 Size 값을 사용하여 이 구조체의 사용 버전을 확인합니다. SPB_CONNECTION_PARAMETERS_INIT 함수를 사용하여 이 멤버를 초기화합니다. 자세한 내용은 아래 설명 부분을 참조하십시오.

ConnectionTag

이 대상의 연결 태그에 대한 포인터입니다. 연결 태그는 버스에 대한 대상 디바이스의 연결을 식별하는 연결 ID를 포함하는 불투명 문자열입니다. 자세한 내용은 SPB-Connected 주변 장치에 대한 연결 ID를 참조하세요.

ConnectionParameters

이 대상의 연결 매개 변수에 대한 포인터입니다. 이 멤버는 SPB 컨트롤러 드라이버가 대상과 통신하는 데 필요한 대상별 매개 변수를 포함하는 메모리 버퍼를 가리킵니다. 자세한 내용은 아래 설명 부분을 참조하십시오.

설명

이 구조에는 대상 디바이스를 버스에 연결하는 방법에 대한 정보가 포함되어 있습니다. 클라이언트(주변 드라이버)가 대상 디바이스에 대한 논리적 연결을 열면 SPB 컨트롤러 드라이버가 디바이스에 대한 연결 설정을 검색하고 이러한 설정을 저장합니다. 나중에 클라이언트에서 디바이스로의 I/O 요청에 대한 응답으로 SPB 컨트롤러 드라이버는 연결 설정을 사용하여 버스에서 디바이스에 액세스하도록 컨트롤러를 구성합니다.

예를 들어 I2C 버스의 디바이스에 대한 연결 설정에는 다음이 포함됩니다.

대상 디바이스의 버스 상대 주소입니다.
대상 디바이스에 액세스하는 데 사용할 주소 비트 수입니다.
대상 디바이스에 액세스하는 데 사용할 버스 클록 빈도입니다.

SPB_CONNECTION_PARAMETERS 구조체의 ConnectionParameters 멤버는 버스의 대상 디바이스에 대한 연결 설정을 포함하는 버퍼에 대한 포인터입니다. ConnectionParameters 멤버를 사용하여 이러한 연결 매개 변수를 가져오는 코드 예제는 디바이스에 대한 연결 설정을 가져오는 방법을 참조하세요.

SpbTargetGetConnectionParameters 메서드를 호출하여 대상 디바이스를 나타내는 SPBTARGET 핸들에 대한 연결 매개 변수를 가져옵니다. 이 메서드는 호출자가 제공하는 SPB_CONNECTION_PARAMETERS 구조에 연결 매개 변수를 씁니다. SpbTargetGetConnectionParameters에 이 구조를 전달하기 전에 SPB_CONNECTION_PARAMETERS_INIT 함수를 호출하여 구조를 초기화합니다.

클라이언트(주변 드라이버)를 대신하여 연결을 열려면 SPB 프레임워크 확장(SpbCx)은 SPB 컨트롤러 드라이버의 EvtSpbTargetConnect 콜백 함수를 호출합니다. 연결을 닫기 위해 SpbCx는 SPB 컨트롤러 드라이버의 EvtSpbTargetDisconnect 콜백 함수를 호출합니다. SPB 컨트롤러 드라이버는 일반적으로 드라이버의 EvtSpbTargetConnect 함수에서 SpbTargetGetConnectionParameters를 호출합니다.