wasapi: Deal with device failures when we aren't holding the device lock.

Since these get proxied to a different thread, if we wait for that thread
to finish while holding the lock, and the management thread _also_ requests
the lock, we're screwed.

WaitDevice never holds the lock by design, so just mark devices as failed
and clean up or recover them in there.
main
Ryan C. Gordon 2023-09-27 11:33:51 -04:00
parent ea5f59c234
commit 505dc4c39c
3 changed files with 28 additions and 15 deletions

View File

@ -819,7 +819,9 @@ SDL_bool SDL_OutputAudioThreadIterate(SDL_AudioDevice *device)
SDL_bool retval = SDL_TRUE; SDL_bool retval = SDL_TRUE;
int buffer_size = device->buffer_size; int buffer_size = device->buffer_size;
Uint8 *device_buffer = current_audio.impl.GetDeviceBuf(device, &buffer_size); Uint8 *device_buffer = current_audio.impl.GetDeviceBuf(device, &buffer_size);
if (!device_buffer) { if (buffer_size == 0) {
// WASAPI (maybe others, later) does this to say "just abandon this iteration and try again next time."
} else if (!device_buffer) {
retval = SDL_FALSE; retval = SDL_FALSE;
} else { } else {
SDL_assert(buffer_size <= device->buffer_size); // you can ask for less, but not more. SDL_assert(buffer_size <= device->buffer_size); // you can ask for less, but not more.

View File

@ -265,6 +265,7 @@ static int mgmtthrtask_DetectDevices(void *userdata)
static void WASAPI_DetectDevices(SDL_AudioDevice **default_output, SDL_AudioDevice **default_capture) static void WASAPI_DetectDevices(SDL_AudioDevice **default_output, SDL_AudioDevice **default_capture)
{ {
int rc; int rc;
// this blocks because it needs to finish before the audio subsystem inits
mgmtthrtask_DetectDevicesData data = { default_output, default_capture }; mgmtthrtask_DetectDevicesData data = { default_output, default_capture };
WASAPI_ProxyToManagementThread(mgmtthrtask_DetectDevices, &data, &rc); WASAPI_ProxyToManagementThread(mgmtthrtask_DetectDevices, &data, &rc);
} }
@ -277,21 +278,18 @@ static int mgmtthrtask_DisconnectDevice(void *userdata)
void WASAPI_DisconnectDevice(SDL_AudioDevice *device) void WASAPI_DisconnectDevice(SDL_AudioDevice *device)
{ {
// this runs async, so it can hold the device lock from the management thread. int rc; // block on this; don't disconnect while holding the device lock!
WASAPI_ProxyToManagementThread(mgmtthrtask_DisconnectDevice, device, NULL); WASAPI_ProxyToManagementThread(mgmtthrtask_DisconnectDevice, device, &rc);
} }
static SDL_bool WasapiFailed(SDL_AudioDevice *device, const HRESULT err) static SDL_bool WasapiFailed(SDL_AudioDevice *device, const HRESULT err)
{ {
if (err == S_OK) { if (err == S_OK) {
return SDL_FALSE; return SDL_FALSE;
} } else if (err == AUDCLNT_E_DEVICE_INVALIDATED) {
if (err == AUDCLNT_E_DEVICE_INVALIDATED) {
device->hidden->device_lost = SDL_TRUE; device->hidden->device_lost = SDL_TRUE;
} else { } else {
IAudioClient_Stop(device->hidden->client); device->hidden->device_dead = SDL_TRUE;
WASAPI_DisconnectDevice(device);
} }
return SDL_TRUE; return SDL_TRUE;
@ -368,10 +366,13 @@ static int mgmtthrtask_ActivateDevice(void *userdata)
static int ActivateWasapiDevice(SDL_AudioDevice *device) static int ActivateWasapiDevice(SDL_AudioDevice *device)
{ {
// this blocks because we're either being notified from a background thread or we're running during device open,
// both of which won't deadlock vs the device thread.
int rc; int rc;
return ((WASAPI_ProxyToManagementThread(mgmtthrtask_ActivateDevice, device, &rc) < 0) || (rc < 0)) ? -1 : 0; return ((WASAPI_ProxyToManagementThread(mgmtthrtask_ActivateDevice, device, &rc) < 0) || (rc < 0)) ? -1 : 0;
} }
// do not call when holding the device lock!
static SDL_bool RecoverWasapiDevice(SDL_AudioDevice *device) static SDL_bool RecoverWasapiDevice(SDL_AudioDevice *device)
{ {
ResetWasapiDevice(device); // dump the lost device's handles. ResetWasapiDevice(device); // dump the lost device's handles.
@ -387,10 +388,16 @@ static SDL_bool RecoverWasapiDevice(SDL_AudioDevice *device)
return SDL_TRUE; // okay, carry on with new device details! return SDL_TRUE; // okay, carry on with new device details!
} }
// do not call when holding the device lock!
static SDL_bool RecoverWasapiIfLost(SDL_AudioDevice *device) static SDL_bool RecoverWasapiIfLost(SDL_AudioDevice *device)
{ {
if (SDL_AtomicGet(&device->shutdown)) { if (SDL_AtomicGet(&device->shutdown)) {
return SDL_FALSE; // already failed. return SDL_FALSE; // already failed.
} else if (device->hidden->device_dead) { // had a fatal error elsewhere, clean up and quit
IAudioClient_Stop(device->hidden->client);
WASAPI_DisconnectDevice(device);
SDL_assert(SDL_AtomicGet(&device->shutdown)); // so we don't come back through here.
return SDL_FALSE; // already failed.
} else if (!device->hidden->client) { } else if (!device->hidden->client) {
return SDL_TRUE; // still waiting for activation. return SDL_TRUE; // still waiting for activation.
} }
@ -403,9 +410,12 @@ static Uint8 *WASAPI_GetDeviceBuf(SDL_AudioDevice *device, int *buffer_size)
// get an endpoint buffer from WASAPI. // get an endpoint buffer from WASAPI.
BYTE *buffer = NULL; BYTE *buffer = NULL;
if (RecoverWasapiIfLost(device) && device->hidden->render) { if (device->hidden->render) {
if (WasapiFailed(device, IAudioRenderClient_GetBuffer(device->hidden->render, device->sample_frames, &buffer))) { if (WasapiFailed(device, IAudioRenderClient_GetBuffer(device->hidden->render, device->sample_frames, &buffer))) {
SDL_assert(buffer == NULL); SDL_assert(buffer == NULL);
if (device->hidden->device_lost) { // just use an available buffer, we won't be playing it anyhow.
*buffer_size = 0; // we'll recover during WaitDevice and try again.
}
} }
} }
@ -423,6 +433,7 @@ static int WASAPI_PlayDevice(SDL_AudioDevice *device, const Uint8 *buffer, int b
static void WASAPI_WaitDevice(SDL_AudioDevice *device) static void WASAPI_WaitDevice(SDL_AudioDevice *device)
{ {
// WaitDevice does not hold the device lock, so check for recovery/disconnect details here.
while (RecoverWasapiIfLost(device) && device->hidden->client && device->hidden->event) { while (RecoverWasapiIfLost(device) && device->hidden->client && device->hidden->event) {
DWORD waitResult = WaitForSingleObjectEx(device->hidden->event, 200, FALSE); DWORD waitResult = WaitForSingleObjectEx(device->hidden->event, 200, FALSE);
if (waitResult == WAIT_OBJECT_0) { if (waitResult == WAIT_OBJECT_0) {
@ -450,10 +461,10 @@ static int WASAPI_CaptureFromDevice(SDL_AudioDevice *device, void *buffer, int b
UINT32 frames = 0; UINT32 frames = 0;
DWORD flags = 0; DWORD flags = 0;
while (RecoverWasapiIfLost(device) && device->hidden->capture) { while (device->hidden->capture) {
HRESULT ret = IAudioCaptureClient_GetBuffer(device->hidden->capture, &ptr, &frames, &flags, NULL, NULL); const HRESULT ret = IAudioCaptureClient_GetBuffer(device->hidden->capture, &ptr, &frames, &flags, NULL, NULL);
if (ret == AUDCLNT_S_BUFFER_EMPTY) { if (ret == AUDCLNT_S_BUFFER_EMPTY) {
return 0; // in theory we should have waited until there was data, but oh well, we'll go back to waiting. Returning 0 is safe in SDL return 0; // in theory we should have waited until there was data, but oh well, we'll go back to waiting. Returning 0 is safe in SDL3.
} }
WasapiFailed(device, ret); // mark device lost/failed if necessary. WasapiFailed(device, ret); // mark device lost/failed if necessary.
@ -472,8 +483,7 @@ static int WASAPI_CaptureFromDevice(SDL_AudioDevice *device, void *buffer, int b
SDL_memcpy(buffer, ptr, cpy); SDL_memcpy(buffer, ptr, cpy);
} }
ret = IAudioCaptureClient_ReleaseBuffer(device->hidden->capture, frames); WasapiFailed(device, IAudioCaptureClient_ReleaseBuffer(device->hidden->capture, frames));
WasapiFailed(device, ret); // mark device lost/failed if necessary.
return cpy; return cpy;
} }

View File

@ -41,12 +41,13 @@ struct SDL_PrivateAudioData
SDL_bool coinitialized; SDL_bool coinitialized;
int framesize; int framesize;
SDL_bool device_lost; SDL_bool device_lost;
SDL_bool device_dead;
void *activation_handler; void *activation_handler;
}; };
/* win32 and winrt implementations call into these. */ /* win32 and winrt implementations call into these. */
int WASAPI_PrepDevice(SDL_AudioDevice *device); int WASAPI_PrepDevice(SDL_AudioDevice *device);
void WASAPI_DisconnectDevice(SDL_AudioDevice *device); void WASAPI_DisconnectDevice(SDL_AudioDevice *device); // don't hold the device lock when calling this!
// BE CAREFUL: if you are holding the device lock and proxy to the management thread with wait_until_complete, and grab the lock again, you will deadlock. // BE CAREFUL: if you are holding the device lock and proxy to the management thread with wait_until_complete, and grab the lock again, you will deadlock.