Структура SYNTHDOWNLOAD (dmusprop.h)

  • Статья

Структура SYNTHDOWNLOAD задает дескриптор для загруженных данных DLS. Он также указывает, можно ли освободить буфер, содержащий данные DLS.

Синтаксис

typedef struct _SYNTHDOWNLOAD {
  HANDLE DownloadHandle;
  BOOL   Free;
} SYNTHDOWNLOAD, *PSYNTHDOWNLOAD;

Члены

DownloadHandle

Обработка загруженного буфера данных DLS, который драйвер минипорта создает для уникальной идентификации данных DLS, чтобы их можно было выгрузить позже.

Free

Указывает, может ли клиент освободить буфер данных после завершения загрузки DLS. Если задано значение TRUE, клиент может освободить буфер после завершения скачивания. Если значение РАВНО FALSE, клиент не должен освобождать буфер, пока он не будет выгружен. Дополнительные сведения см. в разделе "Примечания".

Комментарии

При обработке запроса KSPROPERTY_SYNTH_DLS_DOWNLOAD get-property драйвер мини-порта синтезатора использует структуру SYNTHDOWNLOAD для передачи дескриптора обратно клиенту. Этот дескриптор однозначно идентифицирует скачанные данные DLS. Позже клиент указывает этот же дескриптор в KSPROPERTY_SYNTH_DLS_UNLOAD запросе set-property, который выгружает данные DLS.

Если драйвер минипорта создает собственную копию данных DLS, он устанавливает для параметра Freeзначение TRUE , чтобы указать, что клиент может освободить буфер, содержащий данные DLS, сразу после завершения запроса свойства KSPROPERTY_SYNTH_DLS_DOWNLOAD. Если драйвер минипорта продолжает использовать клиентскую копию данных DLS, он устанавливает значение Free в значение FALSE , чтобы указать, что клиент должен сохранить выделение исходного буфера данных DLS до тех пор, пока не выгрузит данные, отправив запрос свойства KSPROPERTY_SYNTH_DLS_UNLOAD.

Требования

Требование Значение
Заголовок dmusprop.h (включая Dmusprop.h)

См. также раздел

KSPROPERTY_SYNTH_DLS_DOWNLOAD

KSPROPERTY_SYNTH_DLS_UNLOAD