Função PcRegisterSubdevice (portcls.h)

A função PcRegisterSubdevice registra um subdispositivo para disponibilizá-lo para uso por clientes.

Sintaxe

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

Parâmetros

[in] DeviceObject

Ponteiro para o objeto de dispositivo do driver do adaptador. Essa é uma estrutura do sistema do tipo DEVICE_OBJECT.

[in] Name

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica o nome do subdévico. O buffer de cadeia de caracteres para o qual o parâmetro Name aponta deve permanecer válido durante o tempo de vida do objeto do dispositivo. A cadeia de caracteres contém um nome curto que distingue o subdispositivo de quaisquer outros subdispositivos registrados no mesmo dispositivo. Cada um dos subdispositivos do dispositivo deve ter um nome exclusivo.

[in] Unknown

Ponteiro para a interface IPort do objeto de driver de porta que está associado ao subdispositivo.

Retornar valor

PcRegisterSubdevice retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Caso contrário, ele retornará um código de erro apropriado.

Comentários

A função registra a instância da interface do dispositivo para um objeto de filtro que representa um subdispositivo em um adaptador de áudio. O gerenciador de E/S acrescenta a cadeia de caracteres especificada pelo parâmetro Name à cadeia de caracteres de referência que ele usa para identificar a instância. A cadeia de caracteres de referência modificada é útil para distinguir entre os subdispositivos no adaptador de áudio. Para obter mais informações sobre cadeias de caracteres de referência, consulte IoRegisterDeviceInterface.

Para obter mais informações sobre a função da função PcRegisterSubdevice no registro de um subdispositivo, consulte Criação de subdispositivos.

Um driver de adaptador pode chamar o método IUnregisterSubdevice::UnregisterSubdevice para excluir o registro de uma conexão física que foi registrada por uma chamada anterior para PcRegisterSubdevice. Para obter mais informações, consulte Subdispositivos de Áudio Dinâmico.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	O driver do sistema PortCls implementa a função PcRegisterSubdevice no Microsoft Windows 98/Me e nos sistemas operacionais Windows 2000 e posteriores.
Plataforma de Destino	Universal
Cabeçalho	portcls.h (inclua Portcls.h)
Biblioteca	Portcls.lib
IRQL	PASSIVE_LEVEL

Confira também

DEVICE_OBJECT

Iport

IUnregisterSubdevice::UnregisterSubdevice

IoRegisterDeviceInterface