BdaMethodCreateTopology 함수(bdasup.h)

아티클
05/23/2024

BdaMethodCreateTopology 함수는 필터의 두 핀 사이에 템플릿 토폴로지를 만듭니다.

구문

NTSTATUS BdaMethodCreateTopology(
  [in]       PIRP      pIrp,
  [in]       PKSMETHOD pKSMethod,
  [optional] PVOID     pvIgnored
);

매개 변수

[in] pIrp

토폴로지를 만드는 요청에 대한 IRP를 가리킵니다. BDA 미니드라이버가 KSMETHOD_BDA_CREATE_TOPOLOGY 요청과 함께 이 IRP를 받습니다.

[in] pKSMethod

메서드 요청의 메서드 및 요청 형식을 설명하는 KSMETHOD 구조를 가리킵니다.

[optional] pvIgnored

무시되는 버퍼를 가리킵니다.

반환 값

STATUS_SUCCESS 또는 적절한 오류 코드를 반환합니다.

설명

BDA 미니드라이버가 네트워크 공급자로부터 설정된 KSMETHODSETID_BdaDeviceConfiguration 메서드의 KSMETHOD_BDA_CREATE_TOPOLOGY 요청을 받은 후 BdaMethodCreateTopology 함수를 호출하여 두 필터 핀 간에 템플릿 토폴로지를 만듭니다. 대부분의 BDA 미니드라이버에서는 이러한 미니드라이버가 BdaMethodCreateTopology 함수를 직접 디스패치하도록 디스패치 및 필터 자동화 테이블을 정의할 수 있습니다. 일부 BDA 미니드라이버에서는 직접 디스패치하는 대신 내부 메서드(KStrMethodHandler)를 사용하여 이 요청을 가로채야 합니다. 이러한 미니 드라이버는 BdaMethodCreateTopology 를 호출하기 전에 전달된 IRP에서 BDA 필터에 대한 포인터를 가져와야 필터를 사용하여 연결된 핀을 추적할 수 있습니다. 그런 다음 이러한 미니 드라이버는 특정 핀 유형을 연결할 때 하드웨어에 지침을 보낼 수 있습니다. 자세한 내용은 Automation 테이블 정의 및 BDA 필터 구성 을 참조하세요.

BDA 미니드라이버가 네트워크 공급자를 사용하지 않고 두 필터 핀 간에 템플릿 토폴로지를 만들어야 하는 경우 BDA 미니드라이버에서 BdaCreateTopology 함수를 호출해야 합니다.