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 데이터를 고유하게 식별합니다. 클라이언트는 나중에 DLS 데이터를 언로드하는 KSPROPERTY_SYNTH_DLS_UNLOAD set-property 요청에서 이 동일한 핸들을 지정합니다.
미니포트 드라이버가 DLS 데이터의 자체 복사본을 만드는 경우 클라이언트가 KSPROPERTY_SYNTH_DLS_DOWNLOAD 속성 요청이 완료되는 즉시 DLS 데이터가 포함된 버퍼를 해제할 수 있음을 나타내도록 Free 매개 변수를 TRUE 로 설정합니다. 그러나 미니포트 드라이버가 DLS 데이터의 클라이언트 복사본을 계속 사용하는 경우 클라이언트가 KSPROPERTY_SYNTH_DLS_UNLOAD 속성 요청을 전송하여 데이터를 언로드할 때까지 원래 DLS 데이터 버퍼의 할당을 유지해야 함을 나타내도록 Free 를 FALSE 로 설정합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 | dmusprop.h(Dmusprop.h 포함) |