Funzione BdaPropertyGetControllingPinId (bdasup.h)

La funzione BdaPropertyGetControllingPinId recupera l'identificatore di un pin in 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.

Commenti

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 del set di proprietà KSPROPSETID_BdaTopology 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 la funzione BdaPropertyGetControllingPinId , senza intercettare questa richiesta usando un gestore get-interno (KStrGetPropertyHandler). Per altre informazioni, vedere Definizione delle tabelle di automazione e Determinazione della topologia del dispositivo BDA .

Requisiti

Vedi anche

KSPROPERTY_BDA_CONTROLLING_PIN_ID

KSPROPSETID_BdaTopology

KSP_BDA_NODE_PIN