BdaPropertyNodeDescriptors 함수(bdasup.h)
BdaPropertyNodeDescriptors 함수는 템플릿 토폴로지의 노드 목록을 검색합니다.
구문
NTSTATUS BdaPropertyNodeDescriptors(
[in] PIRP pIrp,
[in] PKSPROPERTY pKSProperty,
[out, optional] BDANODE_DESCRIPTOR *pNodeDescriptorProperty
);
매개 변수
[in] pIrp
노드 목록을 검색하는 요청에 대한 IRP를 가리킵니다. BDA 미니 드라이버는 KSPROPERTY_BDA_NODE_DESCRIPTORS 요청으로 이 IRP를 받습니다.
[in] pKSProperty
속성 요청의 속성 및 요청 형식을 설명하는 KSPROPERTY 구조를 가리킵니다.
[out, optional] pNodeDescriptorProperty
템플릿 토폴로지의 노드에 대한 GUID 목록을 받는 배열을 가리킵니다.
반환 값
STATUS_SUCCESS 또는 적절한 오류 코드를 반환합니다.
설명
BDA 미니드라이버가 BdaPropertyNodeDescriptors 함수를 호출하여 미니드라이버가 네트워크 공급자로부터 설정된 KSPROPSETID_BdaTopology 속성의 KSPROPERTY_BDA_NODE_DESCRIPTORS 요청을 받은 후 노드 목록을 검색합니다. 대부분의 BDA 미니 드라이버는 내부 get-handler(KStrGetPropertyHandler)를 사용하여 이 요청을 가로채지 않고 해당 미니드라이버가 BdaPropertyNodeDescriptors 함수를 직접 디스패치하도록 디스패치 및 필터 자동화 테이블을 정의할 수 있습니다. 자세한 내용은 Automation 테이블 정의 및 BDA 디바이스 토폴로지 확인을 참조하세요.
템플릿 토폴로지에서 만들 수 있는 BDA 노드 목록은 BDA 노드 범주 GUID를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Microsoft Windows XP 이상 운영 체제에서 사용할 수 있습니다. 이 루틴은 Microsoft DirectX 9.0 이상이 해당 플랫폼에 설치된 경우에만 Windows 2000 플랫폼에서 사용할 수 있습니다. |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | bdasup.h(Bdasup.h 포함) |
| 라이브러리 | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |