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 포함)

추가 정보

KSPROPERTY_SYNTH_DLS_DOWNLOAD

KSPROPERTY_SYNTH_DLS_UNLOAD