 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
The IDsDriver::Openmethod is called by DirectSound to acquire the device for its exclusive use. The driver should acquire the hardware and allocate any necessary structures. Once this method has been called, the Wave portion of the driver should be unable to acquire the use of the hardware; the Wave portion should recognize the device as already allocated.
HRESULT Open( );
Return Values
Returns DS_OK if successful, or DSERR_INVALIDPARAM otherwise.
Remarks
DirectSound guarantees that it only calls the IDsDriver::CreateSoundBuffer, IDsDriver::DuplicateSoundBuffer, and IDsDriver::GetCapsmethods when it successfully opens the device through the IDsDriver::Openmethod.
This method should not increment the reference count on the DirectSound object. The reference count of an object should only be changed by the IUnknownmethods AddRefand Release.
Last updated on Tuesday, July 13, 2004