KsCreateFilterFactory 함수(ks.h)

** KsCreateFilterFactory** 함수는 지정된 디바이스에 필터 팩터리를 추가합니다.

구문

KSDDKAPI NTSTATUS KsCreateFilterFactory(
  [in]            PDEVICE_OBJECT            DeviceObject,
  [in]            const KSFILTER_DESCRIPTOR *Descriptor,
  [in, optional]  PWSTR                     RefString,
  [in, optional]  PSECURITY_DESCRIPTOR      SecurityDescriptor,
  [in]            ULONG                     CreateItemFlags,
  [in, optional]  PFNKSFILTERFACTORYPOWER   SleepCallback,
  [in, optional]  PFNKSFILTERFACTORYPOWER   WakeCallback,
  [out, optional] PKSFILTERFACTORY          *FilterFactory
);

매개 변수

[in] DeviceObject

필터 팩터리를 추가할 DEVICE_OBJECT 구조체에 대한 포인터입니다.

[in] Descriptor

이 팩터리에서 만들 수 있는 개별 필터의 특성을 설명하는 KSFILTER_DESCRIPTOR 대한 포인터입니다.

[in, optional] RefString

이 인수가 제공되면 이 문자열은 이 팩터리에서 만든 필터에 대한 참조 문자열로 사용됩니다. 그렇지 않으면 설명자에 제공된 참조 GUID가 사용됩니다.

[in, optional] SecurityDescriptor

이 필터 팩터리에서 필터를 만드는 데 사용할 보안 설명자입니다. NULL인 경우 설명자가 제공되지 않습니다.

[in] CreateItemFlags

다음 표에서는 미니드라이버 작성기가 새 필터 팩터리에서 만들 수 있는 필터의 특성을 지정하는 데 사용하는 플래그를 나열합니다. 이 매개 변수를 아래 플래그의 비트 OR로 설정합니다.

[in, optional] SleepCallback

이 필터와 연결된 디바이스가 절전 모드로 설정된다는 알림을 받는 미니드라이버 제공 루틴에 대한 포인터입니다. 다음과 같이 루틴을 프로토타입으로 프로토 타입합니다.

void SleepCallback (IN PKSFILTERFACTORY FilterFactory,
    IN DEVICE_POWER_STATE State);

이 매개 변수가 NULL인 경우 이 필터 팩터리는 디바이스가 절전 모드로 설정된다는 알림을 받지 않습니다. 디바이스 전원 상태를 참조하세요.

[in, optional] WakeCallback

이 필터와 연결된 디바이스가 해제되고 있다는 알림을 받는 미니드라이버 제공 루틴에 대한 포인터입니다. 다음과 같이 루틴을 프로토타입으로 프로토 타입합니다.

void WakeCallback (IN PKSFILTERFACTORY FilterFactory,
    IN DEVICE_POWER_STATE State);

이 매개 변수가 NULL인 경우 이 필터 팩터리는 디바이스가 해제되었다는 알림을 받지 않습니다. 디바이스 전원 상태를 참조하세요.

[out, optional] FilterFactory

AVStream이 새로 만든 필터 팩터리 개체를 가리키도록 설정하는 KSFILTERFACTORY 구조체에 대한 포인터입니다. 이 선택적 매개 변수가 지정되지 않은 경우 호출자에게 결과 필터 팩터리 개체에 대한 정보를 제공하지 않습니다.

반환 값

필터 팩터리를 만들 수 있으면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 적절한 오류 코드를 반환합니다.

설명

AVStrMiniDevicePostStart 이후에 KsCreateFilterFactory를 호출하는 경우 KsFilterFactorySetDeviceClassesState를 호출하여 디바이스 클래스를 사용하도록 설정해야 합니다. (또한 KsFilterFactorySetDeviceClassesState 를 호출하여 필터 팩터리를 사용하지 않도록 설정합니다.)

AVStrMiniDevicePostStart 또는 이전 컨텍스트에서 KsCreateFilterFactory를 호출하는 경우 이 작업을 수행할 필요가 없습니다.

이 함수를 호출하기 전에 미니드라이버가 디바이스 뮤텍스를 가져와야 합니다. 이 작업을 수행하는 방법에 대한 자세한 내용은 AVStream의 디바이스 뮤텍스를 참조하세요.

이 함수는 KsInitializeDriver 를 호출하지 않고 자신을 초기화하거나 새 필터 형식을 동적으로 추가하고 제거해야 하는 미니드라이버에서 사용해야 합니다.

요구 사항

추가 정보

KSFILTER_DESCRIPTOR

KSNODE_DESCRIPTOR

KSPIN_DESCRIPTOR_EX

KsDeleteFilterFactory