KSPROPERTY_PIN_MODEDATAFORMATS

아티클
06/15/2023

클라이언트는 KSPROPERTY_PIN_MODEDATAFORMATS 속성을 사용하여 핀 팩터리에서 인스턴스화된 핀에 대해 지원되는 각 오디오 신호 처리 모드에 대해 지원되는 형식 목록을 검색합니다.

사용 요약 테이블

가져오기	설정	대상	속성 설명자 형식	속성 값 형식
예	예	필터	KSP_PIN 뒤에 모드 GUID가 옵니다.	KSMULTIPLE_ITEM 구조체와 KSDATAFORMAT 구조의 시퀀스

설명

클라이언트는 이 속성을 사용하여 핀 팩터리에서 인스턴스화된 핀으로 특정 오디오 신호 처리 모드에 대해 지원되는 형식 목록을 검색합니다.

KSP_PIN 뒤에 모드 GUID를 사용하여 이 속성을 지정합니다. 여기서 KSP_PIN 멤버와 모드 GUID는 핀 팩터리와 형식 목록을 반환할 모드를 지정합니다.

KSPROPERTY_PIN_MODEDATAFORMATS 지원되는 형식을 KSMULTIPLE_ITEM 구조체로 반환합니다. 여기서 구조체의 각 항목은 KSMULTIPLE_ITEM 처음부터 값의 특정 KSDATAFORMAT 구조에 대한 오프셋이 있는 ULONGLONG입니다.

KSMULTIPLE_ITEM::Size 값에는 KSMULTIPLE_ITEM 크기와 각 KSDATAFORMAT의 크기가 포함됩니다.
KSMULTIPLE_ITEM::Count 값에는 각 KSDATAFORMAT에 대한 인덱스 수가 포함됩니다.

거의 모든 경우에 반환되는 KSDATAFORMAT 구조체는 실제로 일치하는 Size를 사용하여 KSDATAFORMAT_WAVEFORMATEXTENSIBLE 또는 KSDATAFORMAT_WAVEFORMATEX 구조체가 됩니다.

예를 들어 두 형식을 지원하는 핀 팩터리의 값은 다음과 같습니다.

{
    // Example Property Value Result, with 2 formats
    // When computing the FormatSize make sure to align the size to ULONGLONG
    // KSDATAFORMAT::Size is WDF_ALIGN_SIZE_UP(KsDataFormat->FormatSize, sizeof(ULONGLONG));
    // Size of the KSMULTIPLE_ITEM structure + Size of two ULONG offset values + Size of first format + Size of second format
    sizeof(KSMULTIPLE_ITEM) + sizeof(ULONG)*2 + (First KSDATAFORMAT::Size) + (Second KSDATAFORMAT::Size),
    // Number of formats being returned
    2,
    // Offset of the first format from the beginning of the Property Value
    2 * sizeof(ULONG),
    // Offset of the second format from the beginning of the Property Value
    2 * sizeof(ULONG) + (First KSDATAFORMAT::Size),
    // First format structure
    {(First KSDATAFORMAT)},
    // Second format structure
    {(Second KSDATAFORMAT)}
}

자세한 내용은 확장 가능한 Wave-Format 설명자를 참조하세요.

지원되는 모드 형식 및 버퍼 권장 사항

Windows 10 버전 2004부터는 드라이버가 지원되는 오디오 신호 처리 모드 형식 및 버퍼 크기 제약 조건을 보고하는 데 KSPROPERTY_PIN_MODEDATAFORMATS 및 KSAUDIO_PACKETSIZE_CONSTRAINTS2 사용하는 것이 좋습니다. 이 방법을 사용하면 Windows 오디오 시스템에서 엔드포인트에서 지원하는 형식 및 버퍼 크기를 검색하기 위해 수많은 스트림을 만들지 않고도 엔드포인트 스트리밍 기능을 효율적으로 검색할 수 있습니다.