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 da 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.
Retornar valor
Retorna STATUS_SUCCESS ou um código de erro apropriado.
Comentários
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 BDA pode definir tabelas de expedição e automação de filtro para que esses minidrivers desempaquem a função BdaPropertyNodeDescriptors diretamente, sem interceptar essa solicitação usando um manipulador de get interno (KStrGetPropertyHandler). Consulte Definindo tabelas de automação e Determinando a topologia do dispositivo BDA para obter mais informações.
Para obter uma lista de nós BDA que estão disponíveis para criar em uma topologia de modelo, consulte GUIDs de categoria de nó do BDA.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | 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. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | bdasup.h (inclua Bdasup.h) |
| Biblioteca | Bdasup.lib |
| IRQL | PASSIVE_LEVEL |