Função BdaPropertyNodeDescriptors (bdasup.h)
A função BdaPropertyNodeDescriptors recupera uma lista de nós em uma topologia de modelo.
Sintaxe
NTSTATUS BdaPropertyNodeDescriptors(
[in] PIRP pIrp,
[in] PKSPROPERTY pKSProperty,
[out, optional] BDANODE_DESCRIPTOR *pNodeDescriptorProperty
);
Parâmetros
[in] pIrp
Aponta para o IRP para a solicitação para recuperar a lista de nós. O minidriver BDA recebe esse IRP com a solicitação KSPROPERTY_BDA_NODE_DESCRIPTORS.
[in] pKSProperty
Aponta para uma estrutura KSPROPERTY que descreve a propriedade e o tipo de solicitação da solicitação de propriedade.
[out, optional] pNodeDescriptorProperty
Aponta para uma matriz que recebe a lista de GUIDs para os nós em uma topologia de modelo.
Valor de retorno
Retorna STATUS_SUCCESS ou um código de erro apropriado.
Observações
Um minidriver BDA chama a função BdaPropertyNodeDescriptors para recuperar a lista de nós depois que o minidriver recebe uma solicitação KSPROPERTY_BDA_NODE_DESCRIPTORS da propriedade KSPROPSETID_BdaTopology definida do provedor de rede. A maioria dos minidrivers do BDA pode definir tabelas de expedição e automação de filtro para que esses minidrivers enviem a função BdaPropertyNodeDescriptor s diretamente, sem interceptar essa solicitação usando um manipulador de obtenção interno (KStrGetPropertyHandler). Consulte Definindo tabelas de automação e determinando de topologia de dispositivo BDA para obter mais informações.
Para obter uma lista de nós BDA disponíveis para criar em uma topologia de modelo, consulte GUIDs de categoria de nó BDA.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Microsoft Windows XP e em sistemas operacionais posteriores. Essa rotina estará disponível na plataforma Windows 2000 somente se o Microsoft DirectX 9.0 e posterior estiver instalado nessa plataforma. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | bdasup.h (inclua Bdasup.h) |
| biblioteca | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |