Funzione PcRegisterSubdevice (portcls.h)

La funzione PcRegisterSubdevice registra un sottodispositivo per renderlo disponibile per l'uso da parte dei client.

Sintassi

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

Parametri

[in] DeviceObject

Puntatore all'oggetto dispositivo del driver dell'adattatore. Si tratta di una struttura di sistema di tipo DEVICE_OBJECT.

[in] Name

Puntatore a una stringa Unicode con terminazione Null che specifica il nome del sottodispositivo. Il buffer stringa a cui punta il parametro Name deve rimanere valido per la durata dell'oggetto dispositivo. La stringa contiene un nome breve che distingue il sottodispositivo da qualsiasi altro sottodispositivo registrato nello stesso dispositivo. Ogni sottodispositivo del dispositivo deve avere un nome univoco.

[in] Unknown

Puntatore all'interfaccia IPort dell'oggetto driver di porta associato al sottodispositivo.

Valore restituito

PcRegisterSubdevice restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato.

Commenti

La funzione registra l'istanza dell'interfaccia del dispositivo per un oggetto filtro che rappresenta un sottodispositivo in una scheda audio. Il gestore di I/O aggiunge la stringa specificata dal parametro Name alla stringa di riferimento utilizzata per identificare l'istanza. La stringa di riferimento modificata è utile per distinguere i sottodispositivi nella scheda audio. Per altre informazioni sulle stringhe di riferimento, vedere IoRegisterDeviceInterface.

Per altre informazioni sul ruolo della funzione PcRegisterSubdevice nella registrazione di un sottodispositivo, vedere Creazione del sottodispositivo.

Un driver dell'adattatore può chiamare il metodo IUnregisterSubdevice::UnregisterSubdevice per eliminare la registrazione di una connessione fisica registrata da una chiamata precedente a PcRegisterSubdevice. Per altre informazioni, vedere Dispositivi secondari audio dinamici.

Requisiti

Requisito	Valore
Client minimo supportato	Il driver di sistema PortCls implementa la funzione PcRegisterSubdevice in Microsoft Windows 98/Me e nei sistemi operativi Windows 2000 e versioni successive.
Piattaforma di destinazione	Universale
Intestazione	portcls.h (include Portcls.h)
Libreria	Portcls.lib
IRQL	PASSIVE_LEVEL

Vedi anche

DEVICE_OBJECT

IPort

IUnregisterSubdevice::UnregisterSubdevice

IoRegisterDeviceInterface