Funzione BdaPropertyGetControllingPinId (bdasup.h)

La funzione BdaPropertyGetControllingPinId recupera l'identificatore di un pin su cui controllare le proprietà, i metodi e gli eventi di un nodo specifico.

Sintassi

NTSTATUS BdaPropertyGetControllingPinId(
  [in]            PIRP              Irp,
  [in]            PKSP_BDA_NODE_PIN Property,
  [out, optional] PULONG            pulControllingPinId
);

Parametri

[in] Irp

Punta all'IRP per la richiesta per recuperare il pin di controllo per un nodo. Il minidriver BDA riceve questo IRP con la richiesta di KSPROPERTY_BDA_CONTROLLING_PIN_ID.

[in] Property

Punta a una struttura KSP_BDA_NODE_PIN che descrive la proprietà e il tipo di richiesta della richiesta di proprietà per recuperare il pin di controllo per un nodo.

[out, optional] pulControllingPinId

Punta a una variabile che riceve l'identificatore del pin di controllo per un nodo.

Valore restituito

Restituisce STATUS_SUCCESS o un codice di errore appropriato.

Osservazioni

Un minidriver BDA chiama la funzione BdaPropertyGetControllingPinId per recuperare l'identificatore del pin di controllo per un nodo dopo che il minidriver riceve una richiesta KSPROPERTY_BDA_CONTROLLING_PIN_ID della proprietà KSPROPSETID_BdaTopology impostata dal provider di rete. La maggior parte dei minidriver BDA può definire tabelle di invio e automazione dei filtri in modo che tali minidriver inviino direttamente il BdaPropertyGetControllingPinId funzione, senza intercettare questa richiesta usando un gestore get interno (KStrGetPropertyHandler). Per altre informazioni, vedere Definizione di tabelle di automazione e Determinazione topologia del dispositivo BDA.

Fabbisogno

Vedere anche

KSPROPERTY_BDA_CONTROLLING_PIN_ID

KSPROPSETID_BdaTopology

KSP_BDA_NODE_PIN