KSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION 구조체(ksmedia.h)

  • 아티클

KSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION 구조는 버퍼 기본 주소, 요청된 버퍼 크기 및 알림 수를 KSPROPERTY 구조에 추가합니다. 이 구조는 클라이언트에서 KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION 통해 오디오 버퍼 할당을 요청하는 데 사용됩니다.

구문

typedef struct {
  KSPROPERTY Property;
  PVOID      BaseAddress;
  ULONG      RequestedBufferSize;
  ULONG      NotificationCount;
} KSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION, *PKSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION;

멤버

Property

KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION 호출하기 전에 클라이언트가 적절하게 초기화하는 KSPROPERTY 구조체입니다.

BaseAddress

버퍼 기본 주소를 지정합니다. 클라이언트가 기본 주소를 지정하지 않는 한 이 매개 변수는 NULL로 설정됩니다.

RequestedBufferSize

버퍼 크기를 바이트 단위로 지정합니다. 드라이버는 반환하는 KSRTAUDIO_BUFFER 구조에서 할당된 버퍼의 실제 크기를 반환합니다.

NotificationCount

주기 버퍼의 주기당 알림 수를 지정합니다. 현재 유효한 값은 1 또는 2입니다. 값이 1이면 주기적 버퍼의 끝에 등록된 알림 이벤트에 대한 알림이 생성됩니다. 값이 2이면 주기적 버퍼의 중간 지점과 끝에 알림이 표시됩니다.

설명

KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION 요청은 KSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION 구조를 사용하여 클라이언트가 요청하는 주기적 버퍼를 설명합니다. 드라이버는 실제로 할당된 버퍼를 설명하는 KSRTAUDIO_BUFFER 구조를 반환합니다.

KSPROPERTY_RTAUDIO_BUFFER 마찬가지로 클라이언트가 RequestedBufferSize 멤버에 쓰는 값은 드라이버에 바인딩되지 않습니다.

KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION 사용하면 DMA가 주기적 버퍼를 통해 진행됨에 따라 이벤트 신호를 쉽게 보낼 수 있습니다. KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT 이러한 알림을 수신하는 이벤트를 등록하는 데 사용되며 KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT 이벤트를 등록 취소하는 데 사용됩니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista 이상 Windows 운영 체제에서 사용할 수 있습니다.
머리글 ksmedia.h

추가 정보

KSPROPERTY

KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION

KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT

KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT