Método IDeviceTopology::GetSubunit (devicetopology.h)
El método GetSubunit obtiene la subunidad especificada por un número de subunidad.
Sintaxis
HRESULT GetSubunit(
[in] UINT nIndex,
[out] ISubunit **ppSubunit
);
Parámetros
[in] nIndex
Número de subunidad. Si una topología de dispositivo contiene n subunits, las subunidades se numeran de 0 a n– 1. Para obtener el número de subunidades en la topología del dispositivo, llame al método IDeviceTopology::GetSubunitCount .
[out] ppSubunit
Puntero a una variable de puntero en la que el método escribe la dirección de la interfaz ISubunit del objeto de subbúnit. A través de este método, el autor de la llamada obtiene una referencia contada a la interfaz . El autor de la llamada es responsable de liberar la interfaz, cuando ya no es necesario, llamando al método Release de la interfaz. Si se produce un error en la llamada a GetSubunit , *ppSubunit es NULL.
Valor devuelto
Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los códigos de retorno posibles incluyen, entre otros, los valores que se muestran en la tabla siguiente.
| Código devuelto | Descripción |
|---|---|
|
El parámetro nIndex está fuera del intervalo. |
|
El puntero ppSubunit es NULL. |
Requisitos
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | devicetopology.h |