Metodo IMiniportMidi::Init (portcls.h)

Articolo
02/26/2024

Il Init metodo inizializza l'oggetto miniport MIDI.

Sintassi

NTSTATUS Init(
  [in]  PUNKNOWN      UnknownAdapter,
  [in]  PRESOURCELIST ResourceList,
  [in]  PPORTMIDI     Port,
  [out] PSERVICEGROUP *ServiceGroup
);

Parametri

[in] UnknownAdapter

Puntatore all'interfaccia IUnknown dell'oggetto adapter il cui oggetto miniport viene inizializzato. Questo parametro è facoltativo e può essere specificato come NULL. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

[in] ResourceList

Puntatore all'interfaccia IResourceList dell'oggetto elenco di risorse da fornire al driver miniport durante l'inizializzazione. Dopo aver passato questo riferimento al driver miniport, il driver della porta è libero di esaminare il contenuto dell'elenco di risorse, ma non modifica il contenuto di questo elenco. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

[in] Port

Puntatore all'oggetto IPortMidi associato a questo oggetto miniport. Il chiamante specifica un valore di puntatore non NULL valido per questo parametro.

[out] ServiceGroup

Puntatore di output per il gruppo di servizi. Questo parametro punta a una variabile puntatore allocata dal chiamante in cui il metodo scrive un puntatore all'interfaccia IServiceGroup dell'oggetto del gruppo di servizi del driver miniport. Si tratta del gruppo di servizi che viene registrato per la notifica di interruzione. Il chiamante specifica un valore di puntatore non NULL valido per questo parametro.

Valore restituito

Init restituisce STATUS_SUCCESS se la chiamata ha esito positivo. In caso contrario, il metodo restituisce un codice di errore appropriato.

Commenti

Il parametro UnknownAdapter è facoltativo:

Se UnknownAdapter non è NULL, il Init metodo esegue una query sull'oggetto UnknownAdapter per l'interfaccia IInterruptSync .
Se UnknownAdapter è NULL, il Init metodo chiama PcNewInterruptSync per creare un nuovo oggetto IInterruptSync . In questo caso, l'elenco di risorse che ResourceList punta a specificare la risorsa di interruzione usata dal nuovo oggetto IInterruptSync .

In entrambi i casi, il metodo e chiama il Init metodo RegisterServiceRoutine nell'oggetto IInterruptSync per aggiungere la routine di interruzione del driver miniport all'elenco delle routine di sincronizzazione degli interruzioni. Quando il driver dell'adattatore libera l'oggetto porta, il driver di porta rilascia il riferimento all'oggetto IInterruptSync .

I parametri UnknownAdapter e ResourceList sono gli stessi valori del puntatore passati in precedenza al metodo Init dell'oggetto IPortMidi (vedere IPort::Init).

I parametri UnknownAdapter, ResourceList, Port e ServiceGroup seguono le convenzioni di conteggio dei riferimenti per gli oggetti COM.