DirectShow DirectShow 레퍼런스 인터페이스 IMemAllocator SetProperties   [목차열람] [주소복사] [슬롯비우기]
IMemAllocator::SetProperties
 
Microsoft DirectX 9.0

IMemAllocator::SetProperties

SetProperties 메서드는, 할당하는 버퍼의 수와 각 버퍼의 사이즈를 지정한다.

구문

HRESULT SetProperties(
  ALLOCATOR_PROPERTIES *pRequest,
  ALLOCATOR_PROPERTIES *pActual
);

파라미터

pRequest

버퍼 요구를 넣는 ALLOCATOR_PROPERTIES 구조체의 포인터.

pActual

실제의 버퍼 프로퍼티를 받는 ALLOCATOR_PROPERTIES 구조체의 포인터.

반환값

HRESULT 값을 돌려준다. 가능한 값은 다음의 일람대로이다.

값 설명
S_OK 성공.
E_POINTER NULL 포인터 인수.
VFW_E_ALREADY_COMMITTED 필터가 액티브한 동안은, 할당한 메모리는 변경할 수 없다.
VFW_E_BADALIGN 무효인 alignment가 지정되었다.
VFW_E_BUFFERS_OUTSTANDING 1 개 또는 복수의 버퍼가 액티브하다.

주의

이 메서드는 버퍼 요구를 지정하지만, 버퍼를 할당하는 것은 아니다. IMemAllocator::Commit 메서드를 호출해 버퍼를 할당하는 것.

호출원래는 2 개의 ALLOCATOR_PROPERTIES 구조체를 할당한다. pRequest 인수에는 버퍼의 수와 각 버퍼의 사이즈를 포함한 호출원의 버퍼 요구가 들어간다. 메서드가 돌아갔을 때,pActual 인수에는 할당자에 의해 설정된 실제의 버퍼 프로퍼티가 들어간다.

이 메서드를 호출하는 경우, 할당자는 결코 위탁되어 있거나, 미해결의 버퍼가 남아 있거나 해서는 안 된다.

참조

↑TOP