Função PcRegisterSubdevice (portcls.h)
A função PcRegisterSubdevice registra um subconjunto 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. Esta é 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 subdevice. O buffer de cadeia de caracteres para o qual o Name parâmetro 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 subdevice de quaisquer outros subdevices registrados no mesmo dispositivo. Cada um dos subdevices do dispositivo deve ter um nome exclusivo.
[in] Unknown
Ponteiro para a interface IPort do objeto de driver de porta associado ao subdevice.
Valor de retorno
PcRegisterSubdevice retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Caso contrário, ele retornará um código de erro apropriado.
Observações
A função registra a instância da interface do dispositivo para um objeto de filtro que representa um subconjunto 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 subdevices 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 subdevice, consulte de Criação de Subdevice.
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 Subdevices de áudio dinâmico.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | O driver do sistema PortCls implementa a função PcRegisterSubdevice no Microsoft Windows 98/Me e no Windows 2000 e em sistemas operacionais posteriores. |
| da Plataforma de Destino | Universal |
| cabeçalho | portcls.h (inclua Portcls.h) |
| biblioteca | Portcls.lib |
| IRQL | PASSIVE_LEVEL |