Función PcRegisterSubdevice (portcls.h)

La función PcRegisterSubdevice registra un subdispositivo para que esté disponible para su uso por parte de los clientes.

Sintaxis

PORTCLASSAPI NTSTATUS PcRegisterSubdevice(
  [in] PDEVICE_OBJECT DeviceObject,
  [in] PWSTR          Name,
  [in] PUNKNOWN       Unknown
);

Parámetros

[in] DeviceObject

Puntero al objeto de dispositivo del controlador del adaptador. Se trata de una estructura del sistema de tipo DEVICE_OBJECT.

[in] Name

Puntero a una cadena Unicode terminada en null que especifica el nombre del subdevice. El búfer de cadena al que apunta el parámetro Name debe permanecer válido durante la vigencia del objeto de dispositivo. La cadena contiene un nombre corto que distingue el subdispositivo de cualquier otro subdispositivo registrado en el mismo dispositivo. Cada uno de los subdispositivos del dispositivo debe tener un nombre único.

[in] Unknown

Puntero a la interfaz IPort del objeto del controlador de puerto enlazado al subdispositivo.

Valor devuelto

PcRegisterSubdevice devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, devuelve un código de error adecuado.

Comentarios

La función registra la instancia de interfaz del dispositivo para un objeto de filtro que representa un subdispositivo en un adaptador de audio. El administrador de E/S anexa la cadena especificada por el parámetro Name a la cadena de referencia que usa para identificar la instancia. La cadena de referencia modificada es útil para distinguir entre los subdispositivos del adaptador de audio. Para obtener más información sobre las cadenas de referencia, consulte IoRegisterDeviceInterface.

Para obtener más información sobre el rol de la función PcRegisterSubdevice en el registro de un subdispositivo, vea Creación de subdispositivos.

Un controlador de adaptador puede llamar al método IUnregisterSubdevice::UnregisterSubdevice para eliminar el registro de una conexión física registrada por una llamada anterior a PcRegisterSubdevice. Para obtener más información, vea Subdevices de audio dinámico.

Requisitos

Consulte también

DEVICE_OBJECT

IPort

IUnregisterSubdevice::UnregisterSubdevice

IoRegisterDeviceInterface