Структура 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 false, чтобы указать, что клиент должен поддерживать выделение исходного буфера данных DLS, пока не выгрузит данные, отправив запрос KSPROPERTY_SYNTH_DLS_UNLOAD свойств.
Требования
| Требование | Ценность |
|---|---|
| заголовка | dmusprop.h (include Dmusprop.h) |