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
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | El controlador del sistema PortCls implementa la función PcRegisterSubdevice en Microsoft Windows 98/Me y en los sistemas operativos Windows 2000 y versiones posteriores. |
| Plataforma de destino | Universal |
| Encabezado | portcls.h (incluya Portcls.h) |
| Library | Portcls.lib |
| IRQL | PASSIVE_LEVEL |