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 |